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

目的：
1.arcgis server9.2 ADF的无刷新机制。
准备：
1.（一、一）的工程，具体见前篇。
开始：
1. 先把上篇里漏下的ScaleBar（比例尺）和Magnifier（放大镜）功能补上，从工具栏拖一个ScaleBar和Magnifier控件到页面上ID分别为ScaleBar1和Magnifier1。
2.设置ScaleBar1，首先给esri:ScaleBar加上Style=" left: 278px; position: absolute; top: 485px; "这样做的目的就是可以使得ScaleBar1浮在地图上面，把页面切换到设计视图，选择ScaleBar1把它位置拖动到地图的右下角的位置，设置Map属性为Map1,设置BarUnits（单位）属性为Kilometers（千米）， BarUnits有Miles（英里）、Kilometers（千米）、Feet（英尺）、Meters(米)四种选择，找了一下汉化单位的方法好像没有找到了，只能这样了。
3.设置Magnifier1，首先给esri:Magnifier加上style="position: absolute; left: 179px; top: 122px;"然后在设计视图中拖动到合适的位置，设置Map属性为Map1，MagnifierMapResource属性为MapResourceManager1，MagnifierMapResource属性为MapResourceItem0，MagnificationFactor属性设置默认放大倍数。
4.这样就完成了ScaleBar（比例尺）和Magnifier（放大镜）功能，可以调试运行一下查看效果。
5.开始功能代码，Default.aspx页面切换到代码视图，按照页生命周期顺序来说明代码。
6.首先添加ESRI.ArcGIS.ADF.Web.UI.WebControls的引用，输入页面的Page_PreInit方法，代码如下：

 1protected void Page_PreInit(object sender, EventArgs e)
 2{
 3  //找到页面中的OverviewMap_Panel控件
 4  FloatingPanel ovPanel = Page.FindControl("OverviewMap_Panel") as FloatingPanel;
 5if (ovPanel != null)
 6{
 7   OverviewMap ov = ovPanel.FindControl("OverviewMap1") as OverviewMap;
 8   //如果OverviewMap1不为空OverviewMap_Panel的状态为展开状态
 9if (ov != null)
{
   ov.Enabled = ovPanel.Expanded;
}
}
}

7.Page_Load事件，首先去掉了一些比较复杂的代码从简单到复杂的分析，代码和说明如下：

 1//载入标识
 2        public string m_newLoad = "false";
 3
 4        protected void Page_Load(object sender, EventArgs e)
 5        {
 6            if (!Page.IsCallback && !Page.IsPostBack)
 7            {
 8                //Map1控件的MapResourceManager检查
 9                if (Map1.MapResourceManager == null || Map1.MapResourceManager.Length == 0)
                {
                    //调用页面错误方法
                    callErrorPage("No MapResourceManager defined for the map.", null);
                }
                //MapResourceManager1控件的ResourceItems检查
                if (MapResourceManager1.ResourceItems.Count == 0 || MapResourceManager1.ResourceItems[0] == null)
                {
                    //调用页面错误方法
                    callErrorPage("The MapResourceManager does not have a valid ResouceItem Definition.", null);
                }
                //
                m_newLoad = "true";
            }

            //获取OverviewMap_Panel控件
            FloatingPanel ovPanel = Page.FindControl("OverviewMap_Panel") as FloatingPanel;
            if (ovPanel != null)
            {
                //设置OverviewMap_Pane的关闭事件
                ovPanel.PanelCollapsed += new ESRI.ArcGIS.ADF.Web.UI.WebControls.FloatingPanelCollapseEventHandler(OverviewMap_Panel_PanelCollapsed);
                //设置OverviewMap_Pane的展开事件
                ovPanel.PanelExpanded += new ESRI.ArcGIS.ADF.Web.UI.WebControls.FloatingPanelExpandEventHandler(OverviewMap_Panel_PanelExpanded);
            }
        }

        //OverviewMap的展开事件
        void OverviewMap_Panel_PanelExpanded(object sender, EventArgs args)
        {
            FloatingPanel ovPanel = Page.FindControl("OverviewMap_Panel") as FloatingPanel;
            if (ovPanel != null)
            {
                OverviewMap ov = ovPanel.FindControl("OverviewMap1") as OverviewMap;
                if (ov != null)
                {
                    //激活OverviewMap1鹰眼
                    ov.Enabled = true;
                    //刷新鹰眼
                    ov.Refresh();

                    //进行回调登记
                    ovPanel.CallbackResults.CopyFrom(ov.CallbackResults);
                }
            }
        }

        //OverviewMap的关闭事件
        void OverviewMap_Panel_PanelCollapsed(object sender, EventArgs args)
        {
            FloatingPanel ovPanel = Page.FindControl("OverviewMap_Panel") as FloatingPanel;
            if (ovPanel != null)
            {
                OverviewMap ov = ovPanel.FindControl("OverviewMap1") as OverviewMap;
                if (ov != null)
                {
                    //不激活OverviewMap1鹰眼
                    ov.Enabled = false;
                }   
            }
        }

        //发生错误是跳到ErrorPage.aspx页面
        private void callErrorPage(string errorMessage, Exception exception)
        {
            //存储错误信息到Session
            Session["ErrorMessage"] = errorMessage;
            Session["Error"] = exception;

            Page.Response.Redirect("ErrorPage.aspx", true);
        }

8.接下来页面要实现 ICallbackEventHandler这个接口，关于 ICallbackEventHandler的资料网上很多了，通过实现 ICallbackEventHandler接口实现了NET中页面的无回调刷新。 实现 ICallbackEventHandler接口就必须实现string ICallbackEventHandler.GetCallbackResult()和void ICallbackEventHandler.RaiseCallbackEvent(string eventArgument)这2个方法具体代码和说明如下：

 1public partial class _Default : System.Web.UI.Page, ICallbackEventHandler
 2.
 3
 4ICallbackEventHandler 成员#region ICallbackEventHandler 成员
 5
 6//负责把结果回传给客户端
 7string ICallbackEventHandler.GetCallbackResult()
 8{
 9    throw new Exception("The method or operation is not implemented.");
}

//负责从客户端javascript传来的参数
void ICallbackEventHandler.RaiseCallbackEvent(string eventArgument)
{
   throw new Exception("The method or operation is not implemented.");
}

#endregion

9.用ICallbackEventHandler的方式实现页面关闭和页面版权显示2个功能，首先添加m_closeOutCallback和m_copyrightCallback两个全局的字符串变量，这两字符串是生成客户端的javascript用的。然后在Page_Load事件添加生产这两字符内容的代码，具体代码如下：

 1//关闭javascript段
 2public string m_closeOutCallback = "";
 3//版权javascript段
 4public string m_copyrightCallback = "";
 5
 6protected void Page_Load(object sender, EventArgs e)
 7{
 8   
 9
   //通过GetCallbackEventReference生成客户端调用的javascript方法段
   //GetCallbackEventReference (Control control,string argument,string clientCallback,string context) 
  //参数： 
  //control 处理客户端回调的服务器 Control。该控件必须实现 ICallbackEventHandler 接口并提供 RaiseCallbackEvent 方法。 
  //argument 从客户端脚本传递一个参数到服务器端的RaiseCallbackEvent 方法。 
  //clientCallback 一个客户端事件处理程序的名称，该处理程序接收服务器端事件返回的结果。
  //context 启动回调之前在客户端的客户端脚本信息。脚本的结果传回给客户端事件处理程序。
  m_closeOutCallback = Page.ClientScript.GetCallbackEventReference(Page, "argument", "CloseOutResponse", "context", true);
  m_copyrightCallback = Page.ClientScript.GetCallbackEventReference(Page, "argument", "processCallbackResult", "context", true);
   
}

10.把上面的m_closeOutCallback和m_copyrightCallback输出到页面，切换到Default.aspx的html代码页面在页面的结尾处输入如下代码：

 1
 2</form>
 3 
 4    <script language="javascript" type="text/javascript">
 5        newLoad = <%=m_newLoad %>; 
 6        webMapAppCloseCallback = "<%=m_closeOutCallback %>";
 7        webMapAppCopyrightCallback = "<%=m_copyrightCallback %>";
 8        startUp(); 
 9        
    </script> 
</body>
</html>

11.新建JavaScript目录，然后在目录中新建叫WebMapApp.js的js文件，同时在Default.aspx页面用添加对WebMapApp.js文件的引用：<script language="javascript" type="text/javascript" src="javascript/WebMapApp.js"></script> 。WebMapApp.js代码如下：

 1//初始化方法
 2function startUp()
 3{
 4   //暂空
 5}
 6
 7//关闭页面方法
 8function CloseOut() {
 9    //向服务器端传递的参数
    var argument = "ControlID=Map1&ControlType=Map&EventArg=CloseOutApplication";
    var context = map.controlName;
    //用eval执行webMapAppCloseCallback字符串,webMapAppCloseCallback = "WebForm_DoCallback('__Page',argument,CloseOutResponse,context,null,true)";
    eval(webMapAppCloseCallback);
}

//在CloseOut()方法后接收服务器端事件返回的结果对页面进行响应
function CloseOutResponse(response, context) {
    window.close(); 
    document.location = response; 
}

function webMapAppGetCopyrightText() {
    //向服务器端传递的参数
    var argument = "ControlID=Map1&ControlType=Map&EventArg=GetCopyrightText";
    var context = map.controlName;
    //用eval执行webMapAppCopyrightCallback字符串,webMapAppCopyrightCallback = "WebForm_DoCallback('__Page',argument,processCallbackResult,context,null,true)";
    eval(webMapAppCopyrightCallback);
    //显示CopyrightText_Panel，arcgisServer的方法
    showFloatingPanel('CopyrightText_Panel');
}

12.上面的脚本文件中主要实现了CloseOut()和webMapAppGetCopyrightText()两客户端方法，他们是通过执行有服务器端GetCallbackEventReference生成客户端调用的javascript方法段实现无刷新的调用服务器端的方法。
13.接下来在服务器端编写响应上面这2个客户端方法的代码，这2个客户端方法都是通过WebForm_DoCallback与服务器端进行交互，所以需要在服务器端的ICallbackEventHandler.GetCallbackResult()和ICallbackEventHandler.RaiseCallbackEvent(string eventArgument)方法中进行处理，具体代码和说明如下：

  1ICallbackEventHandler 成员#region ICallbackEventHandler 成员
  2
  3        private string _callbackArg;
  4        //负责把结果回传给客户端
  5        string ICallbackEventHandler.GetCallbackResult()
  6        {
  7            return RaiseCallbackEvent(_callbackArg);
  8        }
  9
 10        //负责从客户端javascript传来的参数
 11        void ICallbackEventHandler.RaiseCallbackEvent(string eventArgument)
 12        {
 13            _callbackArg = eventArgument;
 14        }
 15
 16        //对客户端的请求进行处理
 17        public virtual string RaiseCallbackEvent(string responseString)
 18        {
 19            //对请求字符串进行分割以键值的形式放到NameValueCollection m_queryString中，方便接下来的使用
 20            Array keyValuePairs = responseString.Split("&".ToCharArray());
 21            NameValueCollection m_queryString = new NameValueCollection();
 22            string[] keyValue;
 23            string response = "";
 24            if (keyValuePairs.Length > 0)
 25            {
 26                for (int i = 0; i < keyValuePairs.Length; i++)
 27                {
 28                    keyValue = keyValuePairs.GetValue(i).ToString().Split("=".ToCharArray());
 29                    m_queryString.Add(keyValue[0], keyValue[1]);
 30                }
 31            }
 32            else
 33            {
 34                keyValue = responseString.Split("=".ToCharArray());
 35                if (keyValue.Length > 0)
 36                {
 37                    m_queryString.Add(keyValue[0], keyValue[1]);
 38                }
 39            }
 40
 41            //请求字符串样例：ControlID=Map1&ControlType=Map&EventArg=CloseOutApplication，这样就可以很容易理解了
 42            string controlType = m_queryString["ControlType"];
 43            string eventArg = m_queryString["EventArg"];
 44            if (controlType == null)
 45            {
 46                controlType = "Map";
 47            }
 48
 49            //根据controlType的不同对请求做不同的处理
 50            switch (controlType)
 51            {
 52                case "Map":
 53                    if (eventArg == "CloseOutApplication")//关闭页面请求-CloseOut()
 54                    {
 55                        //ServerContext对象，需要 ESRI.ArcGIS.Server;
 56                        IServerContext context;
 57                        for (int i = 0; i < Session.Count; i++)
 58                        {
 59                            //清除session
 60                            context = Session[i] as IServerContext;
 61                            if (context != null)
 62                            {
 63                                context.RemoveAll();
 64                                context.ReleaseContext();
 65                            }
 66                        }
 67                        Session.RemoveAll();
 68                        //从webconfig中获取关闭后的页面地址
 69                        response = ConfigurationManager.AppSettings["CloseOutUrl"];
 70                        if (response == null || response.Length == 0)
 71                        {
 72                            response = "ApplicationClosed.aspx";
 73                        }
 74                    }
 75                    else if (eventArg == "GetCopyrightText")//显示版权-webMapAppGetCopyrightText()
 76                    {
 77                        System.Text.StringBuilder sb = new System.Text.StringBuilder();
 78                        //webMapAppGetCopyrightText()请求服务器后返回结果由processCallbackResult进行客户端处理
 79                        //关于processCallbackResult方法的参数格式 控件类型:::控件ID:::内容类型:::内容，如div:::mydiv:::content:::你好，GIS!
 80                        sb.AppendFormat("///:::{0}:::innercontent:::", "CopyrightTextContents");
 81                        int sbLength = sb.Length;
 82                        //获取版权内容
 83                        sb.Append(GetCopyrightText());
 84                        if (sb.Length == sbLength)
 85                        {
 86                            //没有获取，显示为没有版权
 87                            sb.Append("No Copyright information available.");
 88                        } 
 89                        response = sb.ToString();
 90                    }
 91
 92                    break;
 93                default:
 94                    break;
 95            }
 96            //输出给客户端的内容
 97            return response;
 98        }
 99        #endregion

        private string GetCopyrightText()
        {
            System.Text.StringBuilder sb = new System.Text.StringBuilder();
            string key = "";
            string value = "";
            string dataframeValue = "";
            int layerId;
            foreach (IMapFunctionality mapFunc in Map1.GetFunctionalities())
            {
                //
                if (mapFunc.Supports("GetCopyrightText"))
                {
                    Dictionary<string, string> crDictionary = mapFunc.GetCopyrightText();
                    System.Text.StringBuilder sb2 = new System.Text.StringBuilder();
                    string[] layerIds = null;
                    string[] layerNames = null;
                    mapFunc.GetLayers(out layerIds, out layerNames);
                    foreach (KeyValuePair<string, string> kvPair in crDictionary)
                    {
                        key = kvPair.Key;
                        value = kvPair.Value;
                        if (value != null && value.Length > 0)
                        {
                            if (key != null && key.Length > 0)
                            {
                                layerId = Convert.ToInt32(key);
                                sb2.Append(layerNames[layerId] + ": ");
                                sb2.Append(value + "<br/>");
                            }
                            else
                                dataframeValue = value;
                        }
                    }
                    if (sb2.Length > 0) sb.AppendFormat("<div style='font-weight: bold'>{0}:</div><div style='padding: 0px 5px 5px 5px;font-weight: normal;'>{2}<br/>{1}</div>", mapFunc.Resource.Name, sb2.ToString(), dataframeValue);
                    sb2.Length = 0;
                    dataframeValue = "";
                }
            }
            return sb.ToString();
        }

14.现在在页面上添加一个FloatingPanel控件id为CopyrightText_Panel，在<esri:FloatingPanel标签中添加 Style="left: 540px; position: absolute; top: 145px"，Visible属性为False,在这个FloatingPanel控件添加一个div id为CopyrightTextContents.代码如下：

<esri:FloatingPanel ID="CopyrightText_Panel" runat="server" BackColor="White" BorderColor="Gray"
            BorderStyle="Solid" BorderWidth="1px" Font-Names="Verdana" Font-Size="8pt" ForeColor="Black"
            Height="200px" Style="left: 491px; position: absolute; top: 387px"
            Title="Copyright" TitleBarColor="WhiteSmoke" TitleBarHeight="20px"
            TitleBarSeparatorLine="False" Transparency="35" Width="250px" Visible="False" Docked="False">
           <div id="CopyrightTextContents" style="width: 100%" >Copyright Information</div>
       </esri:FloatingPanel>

15.新建ApplicationClosed.aspx页面，等关闭地图页面后显示的页面。
16.最好在页面上添加2个btton来调用CloseOut()和webMapAppGetCopyrightText()方法，具体代码如下：

<input id="Button1" type="button" value="关闭地图" onclick="CloseOut()" />
        <input id="Button2" type="button" value="显示版权"onclick="webMapAppGetCopyrightText()"/>

17.最后调试运行看效果，剩下的部分下篇在写。