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

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

开始： 
1.新建名为AddGraphics的ASP.NET Web应用程序。
2.在页面上放置1个Map、1个Toc、1个MapResourceManager、1个Toolbar控件，做好相应的设置比较简单也不详细说了，也可以参考前面的几篇文章。
3.主要说一下MapResourceManager1设置了，这次与前几篇不同了用的是ArcGIS Server Internet，用编辑器添加以一个名为ServerResource的MapResourceItem，然后点击Definition属性做如下设置，Type:ArcGIS Server Internet;Data Source:http://机器名/arcgis/services；Identity:输入机器的账号和密码；Resource:(default)@world。
4.在Toolbar1添加一个Tool,Name:AddPointTool;Text:Add Graphic Point;ClientAction:Point;ServerActionAssembly:AddGraphics;ServerActionClass:AddGraphics.ElementGraphicTool。
5.新建GraphicPointTools.cs文件，然后在文件中添加ElementGraphicTool类用来实现AddPointTool的功能，代码和说明如下：

 1public class ElementGraphicTool : IMapServerToolAction
 2    {
 3        void IMapServerToolAction.ServerAction(ToolEventArgs toolEventArgs)
 4        {
 5            //获取map控件
 6            ESRI.ArcGIS.ADF.Web.UI.WebControls.Map adfMap =(ESRI.ArcGIS.ADF.Web.UI.WebControls.Map)toolEventArgs.Control;
 7            //转成点
 8            PointEventArgs pointEventArgs = (PointEventArgs)toolEventArgs;
 9            //屏幕点
            System.Drawing.Point screenPoint = pointEventArgs.ScreenPoint;

            //屏幕坐标转成地理坐标
            ESRI.ArcGIS.ADF.Web.Geometry.Point adfPoint =ESRI.ArcGIS.ADF.Web.Geometry.Point.ToMapPoint(screenPoint.X, screenPoint.Y, adfMap.GetTransformationParams(ESRI.ArcGIS.ADF.Web.Geometry.TransformationDirection.ToMap));
          
            ESRI.ArcGIS.ADF.Web.DataSources.Graphics.MapFunctionality adfGraphicsMapFunctionality = null;
            //MapFunctionality
            foreach (ESRI.ArcGIS.ADF.Web.DataSources.IMapFunctionality mapFunctionality in adfMap.GetFunctionalities())
            {
                //当Resource为ADFGraphicsResource,ADFGraphicsResource为GraphicsLayer， 保存在内存中用显示临时图层
                if (mapFunctionality.Resource.Name == "ADFGraphicsResource")
                {
                    adfGraphicsMapFunctionality =(ESRI.ArcGIS.ADF.Web.DataSources.Graphics.MapFunctionality)mapFunctionality;
                    break;
                }
            }

            //当为null的时候调用Utility.ProcessError方法弹出提示框
            if (adfGraphicsMapFunctionality == null)
            {
                //把Utility.ProcessError处理的CallbackResultCollection结果赋给Map控件
                adfMap.CallbackResults.CopyFrom(Utility.ProcessError("ADF graphics functionality not found"));
                return;
            }

            //从adfGraphicsMapFunctionality获取名为Element Graphics的DataTable
            ESRI.ArcGIS.ADF.Web.Display.Graphics.ElementGraphicsLayer elementGraphicsLayer = null;
            foreach (System.Data.DataTable dataTable in adfGraphicsMapFunctionality.GraphicsDataSet.Tables)
            {
                if (dataTable.TableName == "Element Graphics")
                {
                    elementGraphicsLayer = (ESRI.ArcGIS.ADF.Web.Display.Graphics.ElementGraphicsLayer)dataTable;
                    break;
                }
            }

            //如果名为Element Graphics的DataTable为null，就新建Element Graphics DataTable添加到adfGraphicsMapFunctionality.GraphicsDataSet中,同时刷新Toc1显示
            if (elementGraphicsLayer == null)
            {
                elementGraphicsLayer = new ESRI.ArcGIS.ADF.Web.Display.Graphics.ElementGraphicsLayer();
                elementGraphicsLayer.TableName = "Element Graphics";
                adfGraphicsMapFunctionality.GraphicsDataSet.Tables.Add(elementGraphicsLayer);

                //查找Toc1控件
                Toc adfToc = (Toc)Utility.FindControl("Toc1", adfMap.Page);
                //刷新Toc1控件
                adfToc.Refresh();
                //CallbackResults结果赋给Map控件
                adfMap.CallbackResults.CopyFrom(adfToc.CallbackResults);
            }

            //定义标点样式
            ESRI.ArcGIS.ADF.Web.Display.Symbol.SimpleMarkerSymbol simpleMarkerSymbol =new ESRI.ArcGIS.ADF.Web.Display.Symbol.SimpleMarkerSymbol();
            simpleMarkerSymbol.Color = System.Drawing.Color.Black;
            simpleMarkerSymbol.Width = 10;

            //定义标点选中样式
            ESRI.ArcGIS.ADF.Web.Display.Symbol.SimpleMarkerSymbol simpleSelectedMarkerSymbol =new ESRI.ArcGIS.ADF.Web.Display.Symbol.SimpleMarkerSymbol();
            simpleSelectedMarkerSymbol.Color = System.Drawing.Color.Yellow;
            simpleSelectedMarkerSymbol.Width = 12;
            simpleSelectedMarkerSymbol.Type = ESRI.ArcGIS.ADF.Web.Display.Symbol.MarkerSymbolType.Star;

            ESRI.ArcGIS.ADF.Web.Display.Graphics.GraphicElement graphicElement =new ESRI.ArcGIS.ADF.Web.Display.Graphics.GraphicElement(adfPoint, simpleMarkerSymbol, simpleSelectedMarkerSymbol);
            //把标点添加到elementGraphicsLayer
            elementGraphicsLayer.Add(graphicElement);
            //刷新显示
            if (adfMap.ImageBlendingMode == ImageBlendingMode.WebTier)
            { 
                //整个地图控件刷新
                adfMap.Refresh(); 
            }
            else
            {
                //只刷新部分Resource
                adfMap.RefreshResource(adfGraphicsMapFunctionality.Resource.Name); 
            }
        }
    }

6.新建Utility.cs文件，然后添加上面的ElementGraphicTool类中用到的ProcessError和FindControl方法，具体代码和说明如下：

 1namespace AddGraphics
 2{
 3    public class Utility
 4    {
 5        //错误信息处理
 6        public static ESRI.ArcGIS.ADF.Web.UI.WebControls.CallbackResultCollection ProcessError(string message)
 7        {
 8            //alert错误信息
 9            string jsAlertException = "alert('" + message + "')";
            //用CallbackResult执行js脚本
            ESRI.ArcGIS.ADF.Web.UI.WebControls.CallbackResult alertCallbackResult =new ESRI.ArcGIS.ADF.Web.UI.WebControls.CallbackResult(null, null, "javascript", jsAlertException);

            //设置鼠标的指针显示
            string jsChangeCursor = "map.divObject.style.cursor = map.cursor";
            //用CallbackResult执行js脚本
            ESRI.ArcGIS.ADF.Web.UI.WebControls.CallbackResult cursorCallbackResult =new ESRI.ArcGIS.ADF.Web.UI.WebControls.CallbackResult(null, null, "javascript", jsChangeCursor);

            ESRI.ArcGIS.ADF.Web.UI.WebControls.CallbackResultCollection callbackResultCollection =new ESRI.ArcGIS.ADF.Web.UI.WebControls.CallbackResultCollection();
            callbackResultCollection.Add(alertCallbackResult);
            callbackResultCollection.Add(cursorCallbackResult);

            //返回CallbackResultCollection
            return callbackResultCollection;
        }

        //查找页面控件
        public static Control FindControl(string control, Page page)
        {
            if (page == null || control == null)
            {
                return null;
            } 
            Control buddyControl = page.FindControl(control);
            if (buddyControl == null)
            {
                string webPartControl = GetControlUniqueID(control, page.Controls);
                if (webPartControl != null)
                {
                    buddyControl = page.FindControl(webPartControl);
                }
                else
                {
                    buddyControl = page.FindControl(control);
                }
                    
            }
            return buddyControl;
        }

        public static string GetControlUniqueID(string controlID, ControlCollection controls)
        {
            Control control;
            string uniqueID = null;
            for (int i = 0; i < controls.Count; ++i)
            {
                control = controls[i];
                if (control.ID == controlID)
                {
                    uniqueID = control.UniqueID;
                    break;
                }
                if (control.Controls.Count > 0)
                {
                    uniqueID = GetControlUniqueID(controlID, control.Controls);
                    if (uniqueID != null)
                        break;
                }
            }
            return uniqueID;
        }

    }
}

7.这样就完成了AddGraphics的功能可以运行查看一下效果。 这个例子剩下的部分下篇继续写。