数据绑定多记录 Web 服务器控件

Visual Basic 和 Visual C# 概念

数据绑定多记录 Web 服务器控件<!--NONSCROLLING BANNER END-->

<!-- Topic Status -->

多记录控件（例如 Repeater、DataList、DataGrid、ListBox、CheckBoxList 和 RadioButtonList 控件）被绑定到包含多个数据项的数据源。例如，可以将 DataGrid 控件绑定到数据集中的一个表并且该控件可以直接显示数据。或者可以将 DataList 或 Repeater 控件绑定到数据集中的一个表，并且使该控件可用于子控件。

还可以将 HtmlSelect 控件绑定到多个记录。该过程不同于上面列出的用于 Web 服务器控件的过程。有关详细信息，请参见数据绑定 HTML 服务器控件。

注意此过程讨论将控件绑定到包含多个数据项的对象的设置属性。您还可以使用数据绑定来设置这些控件中单值属性的值。例如，您可以使用单值数据绑定设置该控件的 Width 或 BackColor 属性。有关详细信息，请参见 在设计时数据绑定单值 Web 服务器控件。

绑定多记录控件

1. 将该控件的 DataSource 属性设置为包含您要绑定到的数据项的对象。

   容器对象必须实现 IEnumerable 接口，这包括下列对象：

   • ArrayList 对象
   • 集合
   • 数据阅读器（OleDbDataReader 和 SqlDataReader 类型的对象）
   • DataView 对象
   • DataRow 对象
   • 数据集中的 DataTable 对象
2. 如果数据源是数据集，将 DataMember 属性设置为要绑定到的表的名称。（如果未设置该属性，默认情况下使用数据集中的第一个表。）
3. 如果使用 DataList 或 DataGrid 控件，将 DataKeyField 属性设置为在运行时可使用的列的名称以标识单独的项。如果这是可行的，通常使用数据源的主键列。
4. 如果使用 ListBox、DropDownList、CheckBoxList、RadioButtonList 或 HtmlSelect 控件，将 DataTextField 属性设置为要在控件中显示的数据列的名称。
5. 可以选择设置 DataValueField 属性来指定在用户选择一项时控件应返回为其值的列的名称。
6. 在 Web 窗体页中添加调用控件或页的 DataBind 方法的代码。

   注意通常不需要在每个往返过程中都调用 DataBind 方法（即在页初始化阶段不需要检查回发），因为这样做会替换控件中的值。

   下面的示例说明如何可以数据绑 ListBox 控件。该示例假设您具有名为 DsTitles1 的数据集，并且该数据集包含名为 titles 的表。该表包含两列，一列是标题列，您将其分配给 ListBox 显示文本；另一列是 title_id 列，您将其分配为控件的值。

   ' Visual Basic
   Private Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
      SqlDataAdapter1.Fill(DsTitles1)
      If Not (Me.IsPostBack) Then
         ListBox1.DataSource = DsTitles1
         ListBox1.DataMember = "titles"
         ListBox1.DataTextField = "title"
         ListBox1.DataValueField = "title_id"
         ListBox1.DataBind()
      End If
   End Sub
   
   // C#
   private void Page_Load(object sender, System.EventArgs e)
   {
      sqlDataAdapter1.Fill(dsTitles1);
      if (! this.IsPostBack) 
      {
         ListBox1.DataSource = dsTitles1;
         ListBox1.DataMember = "titles";
         ListBox1.DataTextField = "title";
         ListBox1.DataValueField = "title_id";
         ListBox1.DataBind();
      }
   }

   下面的示例说明如何将 ListBox 控件绑定到当使用 DataCommand 对象来执行 SQL 语句时所返回的数据。命令对象的 ExecuteReader 方法返回数据阅读器对象（在此情况中，是 SqlDataReader 类型的对象），可以直接将 ListBox 控件绑定到该对象。

   注意有关使用数据命令和数据阅读器的详细信息，请参见 执行返回结果集的数据命令。

   ' Visual Basic
   Private Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
      If Not (Me.IsPostBack) Then
         SqlConnection1.Open()
         SqlCommand1.CommandText = "Select au_id, au_lname from authors"
         ListBox1.DataSource = SqlCommand1.ExecuteReader()
         ListBox1.DataTextField = "au_lname"
         ListBox1.DataValueField = "au_id"
         ListBox1.DataBind()
         SqlConnection1.Close()
      End If
   End Sub
   
   // C#
   private void Page_Load(object sender, System.EventArgs e)
   {
      if (! this.IsPostBack) 
      {
         sqlConnection1.Open();
         sqlCommand1.CommandText = "Select au_id, au_lname from authors";
         ListBox1.DataSource = sqlCommand1.ExecuteReader();
         ListBox1.DataTextField = "au_lname";
         ListBox1.DataValueField = "au_id";
         ListBox1.DataBind();
         sqlConnection1.Close();
      }
   }