当前位置：首页 > news >正文

ASP.NET DEMO Ⅳ : 使用数据源控件将数据绑定到 ListControl 上

news 来源：原创 2024/9/30 8:32:34

目的：

1. 展示 ListControl.AppendDataBoundItems 属性用法

2. 展示使用数据源控件绑定联动 ListControl

3.出发点：

a. 今天 csdn 还有网友问，DropDownList 绑定数据后能否插入额外项？答案当然是肯定的。

b. 昨天 forums.asp.net中有人使用数据源控件绑定两个联动DRP，设置第二个DRPAppendDataBoundItems=true，绑定数据后将出现重复数据。

c. 自己学习下数据源绑定控件——用ASP.NET 2.0 一年了，基本还没实践性的操练过数据源控件，总存有疑虑——如此，傻瓜式的东东能上得了台面？

提示：

1. ASP.NET 2.0 为列表型控件基类 ListControl 提供了AppendDataBoundItems 属性，该值指示是否在绑定数据之前清除已存在的列表项。默认值为 false。然而，只要你设置 AppendDataBoundItems=true，无论何时执行数据绑定（首次加载或者回发页面），都不会清除原有数据，而是将绑定数据追加上去。因此，如果我们希望每次绑定数据，插入自己的静态项（如常见的“选择全部”），而且希望在任意位置插入，还是只有手动实现。如果使用数据源控件绑定数据，那么需要选择正确的插入静态项时机。下面我们将展示，数据源绑定控件和手动绑定如何加入自定义额外项。

关于这个问题，早期 scott 在他的blog上做了讨论：

ListControl.AppendDataBoundItems Property in ASP.NET 2.0

2. 继承自 ListControl 的控件包括 BulletedList, CheckBoxList, DropDownList, ListBox, RadioButtonList

所有这些控件用法基本一致，这里我们以 DropDownList （DRP）为例。

3.示例由两个DRP组成，第一个DRP数据来自Northwind的Categories表，第二个DRP展示当前选择的Category的Product。

4.数据源控件包括AccessDataSource, SqlDataSource,ObjectDataSource,XmlDataSource，提供访问不同类型的数据源，如数据库、XML 文件或中间层业务对象。这里我们选择使用SqlDataSource。常规用法，我们都很熟悉，使用配置数据源向导，一路鼠标＋回车，数据库中数据就展示在我们面前。

然而，这里我们希望为Category下来框增加一项“Select All”，以便能列出所有的Product。该模型SQL是通常是这样实现的，即如果参数 @CategoryID IS NULL，我们就返回所有的Product

SELECT [ProductID], [ProductName] FROM [Products] WHERE (@CategoryID IS NULL OR [CategoryID] = @CategoryID)

因此，我们希望SqlDataSource的过滤参数（由Parameter 类的扩展类表示）能接受或者将某个预定值自动将转化为 DBNull，非常幸运，Parameter确实为我们提供了 ConvertEmptyStringToNull 属性以指示是否将空字符串转换为null。默认值为true。

然而，SqlDataSource还公开了一个开关项属性 CancelSelectOnNullParameter，该属性指示当 SqlDataSource的 SelectParameters 集合中包含任何一个参数为空引用时，是否取消数据检索操作。默认值为true。因此，为实现我们的示例，我们需要将其设置为false。

5.现在我们再来看下AppendDataBoundItems 的用法，首先设置 drpCategory.AppendDataBoundItems=True，然后手动添加了一个静态项，text="Select ALL" 而 value=""，就像前面所述，SqlDataSource使用的过滤参数（这里是ControlParameter）会自动将其转换为null。

 
<asp:DropDownList ID="drpCategory" runat="server" AppendDataBoundItems="True" 
            AutoPostBack="True" DataSourceID="dsCategory" DataTextField="CategoryName" 
            DataValueField="CategoryID"> 
            <asp:ListItem Value="">Select All</asp:ListItem> 
        </asp:DropDownList> 
  

对于drpProduct 呢？如果我们依葫芦画瓢：

 
<asp:DropDownList ID="drpProduct" runat="server" DataSourceID="dsProduct" AppendDataBoundItems="true"  
           DataTextField="ProductName" DataValueField="ProductID"> 
           <asp:ListItem Value="">Please select a product</asp:ListItem> 
       </asp:DropDownList> 
  

选择第二次选择Category后我们将得到重复的Product列表：

drp2_thumb%5B2%5D.jpg

因此，我们只有另择他法。回忆 ASP.NET 1.x 我们是如何处理的呢？

 
void drpCategory_SelectedIndexChagned(object sender, EventArgs e) 
   { 
       int selectedCategoryId = -1; 
       // ... 
       //  
       drpProduct.DataSource = BindProductByCategory(selectedCategoryId); 
       drpProduct.DataBind(); 
  
       ListItem item = new ListItem("Please select a product", ""); 
       drpProduct.Items.Insert(0, item);         
   } 
  

然而，由于我们将数据绑定完全委托给数据源控件处理，我们应该在哪里添加我们额外项呢？答案是 ListControl 的 DataBound 事件！该事件在执行数据绑定之后触发。

 
void drpProduct_DataBound(object sender, EventArgs e) 
    { 
        ListItem item = new ListItem("Please select a product", ""); 
        //drpProduct.Items.Add(item); 
        // u can insert the All item to Items at the specified index location, 
        // such as zero 
        drpProduct.Items.Insert(0, item); 
        // u can set the All as the selected item. 
        //drpProduct.SelectedIndex = drpProduct.Items.Count - 1;  
    } 
  

完整代码：

 
<%@ Page Language="C#" AutoEventWireup="true" %> 
  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 
  
<script runat="server">

  
    void Page_Load(Object sender, EventArgs e) 
    { 
         
    } 
  
    void Page_PreRender(object sender, EventArgs e) 
    { 
         
    } 
  
    void drpProduct_DataBound(object sender, EventArgs e) 
    { 
        ListItem item = new ListItem("Please select a product", ""); 
        //drpProduct.Items.Add(item); 
        // u can insert the All item to Items at the specified index location, 
        // such as zero 
        drpProduct.Items.Insert(0, item); 
        // u can set the All as the selected item. 
        //drpProduct.SelectedIndex = drpProduct.Items.Count - 1;  
    } 
     
    protected void dsProduct_Selected(object sender, SqlDataSourceStatusEventArgs e) 
    { 
  
    } 
   </
   script
   > 
  
<html xmlns="http://www.w3.org/1999/xhtml" > 
<head runat="server"> 
    <title>活用 ListControl.AppendDataBoundItems 属性</title> 
</head> 
<body> 
    <form id="form1" runat="server"> 
    <h2 style="text-align:center;">活用 ListControl.AppendDataBoundItems 属性</h2>     
    <div> 
        Category: 
        <asp:DropDownList ID="drpCategory" runat="server" AppendDataBoundItems="True" 
            AutoPostBack="True" DataSourceID="dsCategory" DataTextField="CategoryName" 
            DataValueField="CategoryID"> 
            <asp:ListItem Value="">Select All</asp:ListItem> 
        </asp:DropDownList> 
        <asp:SqlDataSource ID="dsCategory" runat="server" ConnectionString="Data Source=.;Initial Catalog=Northwind;Integrated Security=True" 
            ProviderName="System.Data.SqlClient" SelectCommand="SELECT [CategoryID], [CategoryName] FROM [Categories]"> 
        </asp:SqlDataSource> 
        Product: 
        <asp:DropDownList ID="drpProduct" runat="server" DataSourceID="dsProduct" OnDataBound="drpProduct_DataBound"  
            DataTextField="ProductName" DataValueField="ProductID"> 
        </asp:DropDownList> 
        <asp:SqlDataSource ID="dsProduct" runat="server" ConnectionString="Data Source=.;Initial Catalog=Northwind;Integrated Security=True" 
            ProviderName="System.Data.SqlClient" CancelSelectOnNullParameter="false" SelectCommand="SELECT [ProductID], [ProductName] FROM [Products] WHERE (@CategoryID IS NULL OR [CategoryID] = @CategoryID)" OnSelected="dsProduct_Selected"> 
            <SelectParameters> 
                <asp:ControlParameter ControlID="drpCategory" Name="CategoryID" ConvertEmptyStringToNull="true" 
                    PropertyName="SelectedValue" Type="Int32" /> 
            </SelectParameters> 
        </asp:SqlDataSource> 
        <asp:RequiredFieldValidator ID="RequiredFieldValidator1" runat="server" ErrorMessage="Please select a product" ControlToValidate="drpProduct" Display="Dynamic"></asp:RequiredFieldValidator> 
        <asp:Button ID="btnPostBackTest" Text="PostBack Test" runat="server" /> 
    </div> 
    </form> 
</body> 
</html> 
  