CascadingDropDown

参考：asp.net AJAX中的CascadingDropDown控件使用心得

官方： CascadingDropDown Demonstration，Using CascadingDropDown with a Database

http://www.ajaxasp.net.cn/Demos/CascadingDropDown/CascadingDropDown.aspx

斜体 属性为可选属性：

<ajaxToolkit:CascadingDropDown ID="CDD1" runat="server"



TargetControlID="DropDownList2"



Category="Model"



PromptText="Please select a model"



LoadingText="[Loading models...]"



ServicePath="CarsService.asmx"



ServiceMethod="GetDropDownContents"



ParentControlID="DropDownList1"



SelectedValue="SomeValue" />

• TargetControlID - 扩展的 DropDownList 控件 ID
• Category - 对应的数据的分类，例如上面例子中的“区域”、“省份”或者“城市”
• PromptText - 在 DropDownList 被选择前提示用户的信息
• PromptValue - 对应提示信息的 Value，这里指的是 DropDownList 中一个 ListItem 中的 Value 值
• EmptyText - 当从 Web Service 中获得数据为空的时候 DropDownList 显示的信息，可选
• EmptyValue - 对应当数据项为空的时候 DropDownList 中显示 EmptyText 的信息的 Value，这里指的是 DropDownList 中一个 ListItem 中的 Value 值，可选
• LoadingText - 当 CascadingDropDown 在和 Web Service 进行数据通信的时候显示的信息
• ServicePath - 对应的获得数据的 Web Service 路径，如果对应的 Web Service 方法为当前页的 Web Service 方法时，需要将其指定为空
• ServiceMethod - 对应的获得 Web Service 方法名，它需要指定为如下的函数签名

  [System.Web.Services.WebMethod]
  
      
  
      [System.Web.Script.Services.ScriptMethod]
  
      
  
      public CascadingDropDownNameValue[] GetDropDownContents(
  
      
  
      string knownCategoryValues, string category) { ... }

  注意：

  ---

  你可以替换上面示例中的方法名称，GetDropDownContents 为任何你想要的方法名，但是返回值和参数列表需要保持完全一致。
  
  
• ContextKey - 一个可用于传入 Web Service 方法的参数，该参数将用于 Web Service 根据客户端的不同操作产生相应的不同的返回结果，当采用 ContextKey 的时候，这个方法的函数签名如下表示：

  [System.Web.Services.WebMethod]
  
      
  
      [System.Web.Script.Services.ScriptMethod]
  
      
  
      public CascadingDropDownNameValue[] GetDropDownContents(
  
      
  
      string knownCategoryValues, 
  
      
  
      string category, string contextKey) { ... }

  注意：

  ---

  你可以替换上面示例中的方法名称，GetDropDownContents 为任何你想要的方法名，但是返回值和参数列表需要保持完全一致。
  
  
• UseContextKey - 指定是否采用 ContextKey，当函数签名采用了带有 ContextKey 的函数签名时，这个属性将被自动设置为 True
• ParentControlID - 上一级 DropDownList 控件的 ID，当其没有上一级 DropDownList 的时候，该属性被设置为空，例如上面例子中的 “区域”
• SelectedValue - 默认的初始化选中值的 Value，这里指的是 DropDownList 中 ListItem 的 Value 值

自己写的代码：

服务端代码：

        [WebMethod]
        [System.Web.Script.Services.ScriptMethod()]
        public static AjaxControlToolkit.CascadingDropDownNameValue[] GetParentService(string knownCategoryValues, string category)
        {
            System.Data.DataSet ds = Agr.AgrOperate.GetServiceItemsBy(0);
            if (ds.Tables[0].Rows.Count > 0)
            {
                System.Collections.Generic.List<AjaxControlToolkit.CascadingDropDownNameValue> Values
                    = new System.Collections.Generic.List<AjaxControlToolkit.CascadingDropDownNameValue>();
                Values.Add(new AjaxControlToolkit.CascadingDropDownNameValue("", "-1"));
                foreach (System.Data.DataRow dr in ds.Tables[0].Rows)
                {
                    Values.Add(new AjaxControlToolkit.CascadingDropDownNameValue(dr["ItemsName"].ToString(), dr["PID"].ToString()));
                }
                Values.Add(new AjaxControlToolkit.CascadingDropDownNameValue("其它", "99"));

                return Values.ToArray();
            }
            else
            {
                return null;
            }
        }

        //加载子受理项目
        [WebMethod]
        [System.Web.Script.Services.ScriptMethod()]
        public static AjaxControlToolkit.CascadingDropDownNameValue[] GetSubService(string knownCategoryValues, string category)
        {
            System.Collections.Specialized.StringDictionary kv
                = AjaxControlToolkit.CascadingDropDown.ParseKnownCategoryValuesString(knownCategoryValues);
            int PID;
            //"ParentID"是上一级CascadingDropDown设置的category属性名称 
            if (!kv.ContainsKey("ParentID") || !Int32.TryParse(kv["ParentID"], out PID))
            {
                return null;
            }

            System.Data.DataSet ds = Agr.AgrOperate.GetServiceItemsBy(PID);
            if (ds.Tables[0].Rows.Count > 0)
            {
                System.Collections.Generic.List<AjaxControlToolkit.CascadingDropDownNameValue> Values
                    = new System.Collections.Generic.List<AjaxControlToolkit.CascadingDropDownNameValue>();
                Values.Add(new AjaxControlToolkit.CascadingDropDownNameValue("", "-1"));
                foreach (System.Data.DataRow dr in ds.Tables[0].Rows)
                {
                    Values.Add(new AjaxControlToolkit.CascadingDropDownNameValue(dr["ItemsName"].ToString(), dr["PID"].ToString()));
                }

                return Values.ToArray();
            }
            else
            {
                return null;
            }
        }

 HTML页面代码：

                <td align="right">
                    协议受理项目
                </td>
                <td align="left">
                    <asp:DropDownList ID="drplstParentService" runat="server" BackColor="#FFFFC0" CssClass="cssInputBox"
                        ToolTip="请选择要查询的受理项目" Width="100%">
                    </asp:DropDownList>
                    <cc1:CascadingDropDown ID="CascadingDropDown1" runat="server" TargetControlID="drplstParentService"
                     Category="ParentID" LoadingText="加载中" PromptText="" ServiceMethod="GetParentService">
                    </cc1:CascadingDropDown>
                </td>
                <td align="right">
                    子受理项目
                </td>
                <td align="left">
                    <asp:DropDownList ID="drplstSubService" runat="server" BackColor="#FFFFC0" CssClass="cssInputBox"
                        ToolTip="请选择要查询的子受理项目" Width="100%">
                    </asp:DropDownList>
                    <cc1:CascadingDropDown ID="CascadingDropDown2" runat="server" TargetControlID="drplstSubService" 
                    Category="SubID" LoadingText="加载中" PromptText="" ServiceMethod="GetSubService" ParentControlID="drplstParentService">
                    </cc1:CascadingDropDown>
                </td>

 另：使用 CascadingDropDown 要设置 EnableEventValidation="false" ，哪位高人知道有其他做法吗？