Arcgis server task消息的流程和自定义Task

一、首先先要了解task消息的传递流程（如图）



1、当客户端触发执行Task事件之后，就会执行executeTask（）方法，该方法就会调用另 个一个StartJob（）方法，并给它分配各jobid，用于追踪这个异步请求。
2、StartJob（）方法就会提供一系列的参数给微软的WebForm_DoCallBack()方法，最后经 过WebForm_DoCallBack()进行异步请求，通过参数_callBackArg传入微软异步请求的回调
主体RaiseCallbackEvent中。这样参数就传到的服务端的回调方法中了。
3、服务端的回调方法在处理过程中，会调用GetCallbackReasult（）方法，该方法会根据传 入的不同参数，做出不同的处理(例如传入参数为“EventArg=shown”进会执行显示界面)
4、如果传入GetCallbackReasult（）的参数为（EventArg=startTaskActivityIndicator）就会执行ExecuteTask（）方法，该方法是Task的主体方法，处理主要的业务逻辑。该法处理的结果为Results，该方法执行完之后会调用DisplayReasults（）方法，通过processCallbackReasutl（）将结果返回

二、自定义Task
自定义Task的类必须要继承FloatingPanelTask类，比重写父类的CreateChildControls（），ExecuteTask（），GetCallbackReasut（）方法。
1、CreateChildControls（）方法，是在Task实例化的时候执行，该方法主要是定义Task的 界面的，可以自定义些控件，通过Controls.Add（）方法将控件加入到Task中，这些控件
中必须有个能触发executeTask的事件（比如Button的onclick事件可以为：
string.Format("executeTask({0},\"{1}\");", getAgrString, this.CallbackFunctionString)
其中getAgrString为传入的参数）
2、GetCallbackReasut（）方法，是在客户端触发executeTask（）方法之后执行，可以通过this.CallbackEventArgument得到客户端传过来的参数，并将其中有关逻辑处理的参数放入 this.input中。
3.ExecuteTask（）方法，是Task的核心，在执行完GetCallbackReasut（）方法之后执行，可以从this.input中得到参数处理结果保存在this.Reasults中。

三、自定义Task的例子，
（得到当前服务器的实际，和在Task文本框注入的字符串）
右击解决方案à添加à新建项目à类库（名称改为myTask）

usingSystem;
usingSystem.Collections.Generic;
usingSystem.Linq;
usingSystem.Text;
usingSystem.Web.UI.WebControls;
usingSystem.Collections.Specialized;
using ESRI.ArcGIS.ADF.Web.UI.WebControls;
usingSystem.Web.UI.HtmlControls;

namespacemyTask
{
public class myTask:ESRI .ArcGIS .ADF .Web.UI .WebControls .FloatingPanelTask
{
private TextBox txt = null;
private HtmlInputButton btn = null;
protected override voidCreateChildControls()
{
Controls.Clear();
base.CreateChildControls();
txt = new TextBox();
txt.ID = "txt1";
btn = new HtmlInputButton();
btn.ID = "btn1";
btn.Value = "确定";
Controls.Add(txt);//把textbox添加到Task中
Controls.Add(btn);//把Buttont添加到Task中
string getAgrString =string.Format("'txtboxvalue=' + document.getElementById('{0}').value",txt.ClientID);//把TextBox的值作为参数
string onClickcc =string.Format("executeTask({0},\"{1}\");", getAgrString,this.CallbackFunctionString);//定义executeTask，并给它传入参数
btn.Attributes.Add("onclick", onClickcc);//给Button注册方法，该方法能执行executeTask方法
}

/// <summary>
///
得到参数，并根据不同的参数，执行不同的处理
/// </summary>
/// <returns></returns>
public override stringGetCallbackResult()
{
NameValueCollection namecolltion = CallbackUtility.ParseStringIntoNameValueCollection(this.CallbackEventArgument);
this.input =namecolltion["txtboxvalue"];//得到TextBox的值
return base.GetCallbackResult();
}

public override void ExecuteTask()
{
this.Results = null;
string txtvalue =this.input.ToString();
string heading =string.Format("The time on the server is {0}",DateTime.Now.ToShortDateString());
string detail =string.Format("The value in the Textbox is:{0}", txtvalue);
SimpleTaskResult str = newSimpleTaskResult(heading, detail);
this.Results = str;//把处理结果存入Reasus中
}

public overrideList<ESRI.ArcGIS.ADF.Web.UI.WebControls.GISResourceItemDependency> GetGISResourceItemDependencies()
{
List<ESRI.ArcGIS.ADF.Web.UI.WebControls.GISResourceItemDependency>list = newList<ESRI.ArcGIS.ADF.Web.UI.WebControls.GISResourceItemDependency>();
return list;
}
}
}

按F6编译，ToolBox就会多出一个myTask的控件。