Visual Basic 和 Visual C# 概念 |
<!-- Topic Status -->
多记录控件(例如 Repeater、DataList、DataGrid、ListBox、CheckBoxList 和 RadioButtonList 控件)被绑定到包含多个数据项的数据源。例如,可以将 DataGrid 控件绑定到数据集中的一个表并且该控件可以直接显示数据。或者可以将 DataList 或 Repeater 控件绑定到数据集中的一个表,并且使该控件可用于子控件。
还可以将 HtmlSelect 控件绑定到多个记录。该过程不同于上面列出的用于 Web 服务器控件的过程。有关详细信息,请参见数据绑定 HTML 服务器控件。
注意此过程讨论将控件绑定到包含多个数据项的对象的设置属性。您还可以使用数据绑定来设置这些控件中单值属性的值。例如,您可以使用单值数据绑定设置该控件的 Width 或 BackColor 属性。有关详细信息,请参见 在设计时数据绑定单值 Web 服务器控件。
绑定多记录控件
- 将该控件的 DataSource 属性设置为包含您要绑定到的数据项的对象。
容器对象必须实现 IEnumerable 接口,这包括下列对象:
- ArrayList 对象
- 集合
- 数据阅读器(OleDbDataReader 和 SqlDataReader 类型的对象)
- DataView 对象
- DataRow 对象
- 数据集中的 DataTable 对象
- 如果数据源是数据集,将 DataMember 属性设置为要绑定到的表的名称。(如果未设置该属性,默认情况下使用数据集中的第一个表。)
- 如果使用 DataList 或 DataGrid 控件,将 DataKeyField 属性设置为在运行时可使用的列的名称以标识单独的项。如果这是可行的,通常使用数据源的主键列。
- 如果使用 ListBox、DropDownList、CheckBoxList、RadioButtonList 或 HtmlSelect 控件,将 DataTextField 属性设置为要在控件中显示的数据列的名称。
- 可以选择设置 DataValueField 属性来指定在用户选择一项时控件应返回为其值的列的名称。
- 在 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(); } }