ArcGIS.Server.9.2.DotNet自带例子分析（六、一）

目的：
1.arcgis server9.2 ADF实现Select Features功能。
准备工作：
1.用ArcGis Server Manager或者ArcCatalog发布一个叫world的Map Service,并且把这个Service启动起来。
2.找到DeveloperKit\SamplesNET\Server\Web_Applications目录下的Common_SelectBufferToolCSharp.zip。

开始：
1.新建名为SelectTool的ASP.NET Web应用程序,  然后在页面上添加MapResourceManager1、Map1、Toolbar1、Toc1控件。同时对这些控件做相应的设置，这个已经做了很多次了这里不详细说了，具体可以看前面的几篇文章。
2.MapResourceManager1的MapResourceItem总共有3个从最上层往下分别是Buffer（GraphicsLayer，用来缓冲选择元素高亮显示用）、Selection（GraphicsLayer，用来选择元素高亮显示用）、Data Layers（ArcGIS Server Local，就是显示上面发布的world的Map Service）。
3.Toolbar1中添加一个Tool，Name为Select;Text为Select Features；ToolTip为Select Features；ClientAction为DragRectangle；ServerActionAssembly为SelectTool；ServerActionClass为SelectTool.SelectTool。
4.新建SelectTool.cs文件，在这个文件中编写SelectTool类来实现Tool的ServerActionClass。SelectTool类需要实现IMapServerToolAction的接口，实现这个接口必须实现ServerAction的方法。具体代码如下：

namespace SelectTool
{
    public class SelectTool : IMapServerToolAction
    {
        void IMapServerToolAction.ServerAction(ToolEventArgs args)
        { 
        }
    }
}

5.接下来在ServerAction的方法添加框选查询把结果进行高亮显示的代码，具体代码和说明如下：

 1void IMapServerToolAction.ServerAction(ToolEventArgs args)
 2        {
 3            //Data Layers Resource index为2
 4            int resource_index = 2;
 5            //获取地图控件Map
 6            ESRI.ArcGIS.ADF.Web.UI.WebControls.Map mapctrl = (ESRI.ArcGIS.ADF.Web.UI.WebControls.Map)args.Control;
 7            //从Session获取目标图层的名称
 8            string targetlayername = (string)mapctrl.Page.Session["TargetLayer"];
 9            //矩形参数
            RectangleEventArgs rectargs = (RectangleEventArgs)args;
            //矩形
            System.Drawing.Rectangle myrect = rectargs.ScreenExtent;
            //矩形左下定点坐标转换成地理坐标
            ESRI.ArcGIS.ADF.Web.Geometry.Point minpnt = ESRI.ArcGIS.ADF.Web.Geometry.Point.ToMapPoint(myrect.Left, myrect.Bottom, mapctrl.GetTransformationParams(ESRI.ArcGIS.ADF.Web.Geometry.TransformationDirection.ToMap));
            //矩形右上定点坐标转换成地理坐标
            ESRI.ArcGIS.ADF.Web.Geometry.Point maxpnt = ESRI.ArcGIS.ADF.Web.Geometry.Point.ToMapPoint(myrect.Right, myrect.Top, mapctrl.GetTransformationParams(ESRI.ArcGIS.ADF.Web.Geometry.TransformationDirection.ToMap));
            //
            ESRI.ArcGIS.ADF.Web.Geometry.Envelope mappoly = new ESRI.ArcGIS.ADF.Web.Geometry.Envelope(minpnt, maxpnt);
            //获取Data Layers的MapFunctionality
            ESRI.ArcGIS.ADF.Web.DataSources.IMapFunctionality mf = (ESRI.ArcGIS.ADF.Web.DataSources.IMapFunctionality)mapctrl.GetFunctionality(resource_index);
            //获取Data Layers的Resource
            ESRI.ArcGIS.ADF.Web.DataSources.IGISResource gisresource = mf.Resource;
            //是否支持Query
            bool supported = gisresource.SupportsFunctionality(typeof(ESRI.ArcGIS.ADF.Web.DataSources.IQueryFunctionality));
            if (supported)
            {
                //建立QueryFunctionality
                ESRI.ArcGIS.ADF.Web.DataSources.IQueryFunctionality qfunc = (ESRI.ArcGIS.ADF.Web.DataSources.IQueryFunctionality)gisresource.CreateFunctionality(typeof(ESRI.ArcGIS.ADF.Web.DataSources.IQueryFunctionality), null);
                //查询图层id和名称
                string[] lids;
                string[] lnames;
                qfunc.GetQueryableLayers(null, out lids, out lnames);
                int layer_index = 0;
                //获取目标图层的index
                for (int i = 0; i < lnames.Length; i++)
                {
                    if (lnames[i] == targetlayername)
                    {
                        layer_index = i;
                        break;
                    }
                }
                //SpatialFilter空间过滤
                ESRI.ArcGIS.ADF.Web.SpatialFilter spatialfilter = new ESRI.ArcGIS.ADF.Web.SpatialFilter();
                //是否返回地理元素
                spatialfilter.ReturnADFGeometries = true;
                //返回的最大记录数
                spatialfilter.MaxRecords = 1000;
                //过滤的地理区域
                spatialfilter.Geometry = mappoly;
                //进行查询把结果放入DataTable
                System.Data.DataTable datatable = qfunc.Query(null, lids[layer_index], spatialfilter);

                //把查询结果转成GraphicsLayer，GraphicsLayer是基于System.Data.DataTable类型
                ESRI.ArcGIS.ADF.Web.Display.Graphics.GraphicsLayer graphicslayer = Converter.ToGraphicsLayer(datatable, Color.Yellow, Color.Green);
                //
                IEnumerable gfc = mapctrl.GetFunctionalities();
                ESRI.ArcGIS.ADF.Web.DataSources.Graphics.MapResource gResource = null;
                foreach (IGISFunctionality gfunc in gfc)
                {
                    //当Resource为Selection时
                    if ((gfunc.Resource is ESRI.ArcGIS.ADF.Web.DataSources.Graphics.MapResource) && (gfunc.Resource.Name == "Selection"))
                    {
                        //清除Selection的内容
                        gResource = (ESRI.ArcGIS.ADF.Web.DataSources.Graphics.MapResource)gfunc.Resource;
                        gResource.Graphics.Tables.Clear();
                    }
                    //当Resource为Buffer时
                    else if ((gfunc.Resource is ESRI.ArcGIS.ADF.Web.DataSources.Graphics.MapResource) && (gfunc.Resource.Name == "Buffer"))
                    {
                        //清除Buffer的内容
                        ESRI.ArcGIS.ADF.Web.DataSources.Graphics.MapResource buf_res;
                        buf_res = (ESRI.ArcGIS.ADF.Web.DataSources.Graphics.MapResource)gfunc.Resource;
                        buf_res.Graphics.Tables.Clear();
                    }

                }
                if (gResource == null)
                {
                    return;
                }
                //把查询结果添加到Selection中进行高亮显示
                gResource.Graphics.Tables.Add(graphicslayer);

                //刷新地图显示
                if (mapctrl.ImageBlendingMode == ImageBlendingMode.WebTier)
                { 
                    mapctrl.Refresh(); 
                }
                else if (mapctrl.ImageBlendingMode == ImageBlendingMode.Browser)
                { 
                    mapctrl.RefreshResource(gResource.Name); 
                }

            }
        }

6.加入目标图层的选择功能首先在Default的Page_PreRender方法中绑定可以供选择的图层，具体说明和代码如下：

 1protected void Page_PreRender(object sender, EventArgs e)
 2        {
 3            if (!IsPostBack)
 4            {
 5                //获取Data Layers 的IMapFunctionality
 6                ESRI.ArcGIS.ADF.Web.DataSources.IMapFunctionality mf = (ESRI.ArcGIS.ADF.Web.DataSources.IMapFunctionality)Map1.GetFunctionality(2);
 7
 8                ESRI.ArcGIS.ADF.Web.DataSources.IGISResource gisresource = mf.Resource;
 9                bool supported = gisresource.SupportsFunctionality(typeof(ESRI.ArcGIS.ADF.Web.DataSources.IQueryFunctionality));

                if (supported)
                {
                    //建立QueryFunctionality
                    ESRI.ArcGIS.ADF.Web.DataSources.IQueryFunctionality qfunc = (ESRI.ArcGIS.ADF.Web.DataSources.IQueryFunctionality)gisresource.CreateFunctionality(typeof(ESRI.ArcGIS.ADF.Web.DataSources.IQueryFunctionality), null);

                    string[] lids;
                    string[] lnames;
                    //查询图层id和名称
                    qfunc.GetQueryableLayers(null, out lids, out lnames);
                    for (int i = 0; i < lnames.Length; i++)
                    {
                        //把地图名称添加到DropDownList1
                        DropDownList1.Items.Add(lnames[i]);
                    }
                    //默认的目标图层为DropDownList1的第一项
                    Session["TargetLayer"] = DropDownList1.Items[0].Value;
                }
            }
        } 

7.接下来加入目标图层选择后把选择值存入到Session["TargetLayer"] 中。因为是页面无刷新的执行需要实现ICallbackEventHandler接口。首先是Page_Load事件，具体说明和代码如下：

 1public string sADFCallBackFunctionInvocation;
 2        private string returnstring = "";
 3
 4        protected void Page_Load(object sender, EventArgs e)
 5        {
 6            if (!IsPostBack)
 7            {
 8          
 9                Session["TargetLayer"] = "";
            }
            //给DropDownList1添加下拉选择的js事件
            DropDownList1.Attributes.Add("onchange", "ChangeDDLContext()");
            //服务端对客户端回调脚本段
            sADFCallBackFunctionInvocation = Page.ClientScript.GetCallbackEventReference(this, "message", "processCallbackResult", "context", "postBackError", true);
        }

8.接下来Default.aspx切换到HTML视图添加ChangeDDLContext()脚本方法，具体代码和说明如下：

 1<script language="javascript" type="text/javascript"> 
 2         var context;
 3         //选择目标图层的方法
 4         function ChangeDDLContext()
 5         {
 6            context = 'DDLContext';
 7            ChangeClient(); 
 8         }
 9         
         function ChangeClient()
         {
            var message;
            if (context == 'DDLContext')
            {
              //获取选择值
              var ddl1value = document.getElementById('DropDownList1').value;
              message = 'ddl';
              message += ',' + ddl1value;  
            } 
            //回调方法执行服务端是事情     
            <%=sCallBackFunctionInvocation%>
         }
         
         //服务端回调函数，为空不做任何处理
         function HandleResponse()
         {
         }
         
    </script>

9.接下来进行服务端的功能处理，具体的说明和代码如下：

 1//把服务端的处理结果返回给客户端
 2        public string GetCallbackResult()
 3        {
 4            return returnstring;
 5        }
 6
 7        //接受客户端的请求进行处理
 8        public void RaiseCallbackEvent(string eventArgs)
 9        {
            if (eventArgs.Contains("ddl"))
            {
                ChangeDropDownListServer(eventArgs);
            }
        }

        //保存选择的图层到Session["TargetLayer"]中
        public void ChangeDropDownListServer(string ea)
        {
            char[] parser_char = { ',' };
            string[] messages = ea.Split(parser_char);
            string dll1 = messages[1];
            Session["TargetLayer"] = dll1;
        }

9.这样就完成了框选并且高亮显示被选中的地理元素。接下来要做的功能就是在上面的基础上把框选的结果同时显示在GridView中。
10.在页面上添加ID为griddiv的DIV，然后在这个DIV中添加一个GridView1，同时给griddiv添加style="visibility: hidden; "，使得这个DIV默认不显示，添加一个CheckBox1用来设置是否把结果显示在GridView中。
11.接下来对SelectTool类的ServerAction方法进行修改添加数据在GridView中显示的功能，具体的代码和说明如下：

 1void IMapServerToolAction.ServerAction(ToolEventArgs args)
 2        {
 3..
 4                //获取CheckBox1的是否选择值
 5                string cbxvalue = (string)mapctrl.Page.Session["CheckBox1Value"];
 6                //查找页面中的GridView1
 7                GridView gdview = (GridView)mapctrl.Page.FindControl("GridView1");
 8  
 9                //不显示
                string showtable = "'hidden'";
                //是否在表格中显示结果
                if (bool.Parse(cbxvalue))
                {
                    //把查询结果作为GridView1的数据源进行绑定
                    gdview.DataSource = datatable;
                    gdview.DataBind();

                    //获取GridView1显示html
                    string returnstring = null;
                    StringWriter sw = new StringWriter();
                    HtmlTextWriter htw = new HtmlTextWriter(sw);
                    gdview.RenderControl(htw);
                    htw.Flush();
                    returnstring = sw.ToString();

                    //关于CallbackResult方法的使用可以看前面几篇的文章有详细的说明
                    //无刷新的更新griddiv内容显示，把GridView1的html内容显示在griddiv中
                    CallbackResult cr = new CallbackResult("div", "griddiv", "innercontent", returnstring);
                    mapctrl.CallbackResults.Add(cr);
                    if (datatable.Rows.Count > 1)
                    {
                        showtable = "'visible'";
                    }
                    //关于CallbackResult方法的使用可以看前面几篇的文章有详细的说明
                    //把griddiv的显示状态置为显示
                    object[] oa = new object[1];
                    string sa = "var griddiv = document.getElementById('griddiv');";
                    sa += "griddiv.style.visibility = " + showtable + ";";
                    oa[0] = sa;
                    CallbackResult cr1 = new CallbackResult(null, null, "javascript", oa);
                    mapctrl.CallbackResults.Add(cr1);
                        
                }

..
            }
        }

12.接下拉修改Page_Load方法添加CheckBox1的客户端事件，修改后的代码如下：

 1public string sCallBackFunctionInvocation;
 2        private string returnstring = "";
 3        public string sADFCallBackFunctionInvocation;
 4
 5        protected void Page_Load(object sender, EventArgs e)
 6        {
 7            if (!IsPostBack)
 8            {
 9          
                Session["TargetLayer"] = "";
                Session["CheckBox1Value"] = "false";
            }
            //给DropDownList1添加下拉选择的js事件
            DropDownList1.Attributes.Add("onchange", "ChangeDDLContext()");
            //服务端对客户端回调脚本段
            sCallBackFunctionInvocation = Page.ClientScript.GetCallbackEventReference(this, "message", "HandleResponse", "context", "postBackError", true);

            //给CheckBox1添加点击的js事件
            CheckBox1.Attributes.Add("onclick", "ChangeCheckContext()");
            //服务端对客户端回调脚本段
            sADFCallBackFunctionInvocation = Page.ClientScript.GetCallbackEventReference(this, "message", "processCallbackResult", "context", "postBackError", true);
        }

13.接下来Default.aspx切换到HTML视图添加CheckBox1的点击事件ChangeCheckContext()脚本方法，具体代码和说明如下：

 1function ChangeClient()
 2         {
 3            var message;
 4            
 5            //目标图层选择
 6            if (context == 'DDLContext')
 7            {
 8              //获取选择值
 9              var ddl1value = document.getElementById('DropDownList1').value;
              message = 'ddl';
              message += ',' + ddl1value;  
            } 
            
            //是否在表格中显示数据
            if (context == 'CheckBox')
            {
                var checkboxvalue = document.getElementById('CheckBox1').checked;
                
                message = 'checkbox';
                message += ',' + checkboxvalue;
            }
            
            //回调方法执行服务端是事情     
            <%=sCallBackFunctionInvocation%>
         }
         
         //CheckBox1点击事件
         function ChangeCheckContext(){
         
            context = "CheckBox"
            ChangeClient();
         }

14.修改服务端的RaiseCallbackEvent方法处理客户端脚本ChangeCheckContext()的请求，具体说明和代码如下：

 1//接受客户端的请求进行处理
 2        public void RaiseCallbackEvent(string eventArgs)
 3        {
 4            if (eventArgs.Contains("ddl"))
 5            {
 6                ChangeDropDownListServer(eventArgs);
 7            }
 8            else if (eventArgs.Contains("checkbox"))
 9            {
                ChangeCheckServer(eventArgs);
            }
        }

        //保存是否显示在表格的标识值到Session["CheckBox1Value"]中
        public void ChangeCheckServer(string ea)
        {
            char[] parser_char = { ',' };
            string[] messages = ea.Split(parser_char);
            string check1 = messages[1];
            Session["CheckBox1Value"] = check1;
        }

15.调试运行查看效果，这样框选功能就完成了。本例子剩下的BufferSelect功能下篇在写。