获取或设置多成员数据源中要绑定到数据列表控件的特定数据成员。
命名空间:System.Web.UI.WebControls
程序集:System.Web（在 system.web.dll 中）
<ThemeableAttribute(False)> _
Public Property DataMember As String
Dim instance As BaseDataList
Dim value As String
value = instance.DataMember
instance.DataMember = value
[ThemeableAttribute(false)]
public string DataMember { get; set; }
[ThemeableAttribute(false)]
public:
property String^ DataMember {
String^ get ();
void set (String^ value);
}
/** @property */
public String get_DataMember ()
/** @property */
public void set_DataMember (String value)
public function get DataMember () : String
public function set DataMember (value : String)
属性值
多成员数据源中的数据成员。默认值为 String.Empty。
使用 DataMember 属性指定多成员数据源中要绑定到列表控件的成员。例如，如果有在 DataSource 属性中指定的包含多个表的数据源，请使用 DataMember 属性指定要绑定到数据列表控件的表。
无法通过主题或样式表主题设置此属性。有关更多信息，请参见 ThemeableAttribute 和 ASP.NET 主题和外观概述。
下面的代码示例演示如何使用 DataMember 属性指定 DataSet 对象中要绑定到 DataGrid 控件的表。
<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace = "System.Data" %>
<html>
<head>
<script runat="server">
' Create sample data for the DataGrid control with two tables,
' Employee and Customer.
Function CreateDataSet() As DataSet
' Create a table to store employee values.
Dim EmployeeTable As DataTable = New DataTable("Employee")
Dim TempDataRow As DataRow
' Define the columns for the Employee table.
EmployeeTable.Columns.Add( _
New DataColumn("EmployeeName", GetType(String)))
EmployeeTable.Columns.Add( _
New DataColumn("EmployeeID", GetType(Integer)))
' Populate the Employee table.
Dim i As Integer
For i=1 To 5
TempDataRow = EmployeeTable.NewRow()
TempDataRow(0) = "Employee " & i.ToString()
TempDataRow(1) = (i+1700)
EmployeeTable.Rows.Add(TempDataRow)
Next
' Create a table to store customer values.
Dim CustomerTable As DataTable = New DataTable("Customer")
' Define the columns for the Customer table.
CustomerTable.Columns.Add( _
New DataColumn("CustomerName", GetType(String)))
CustomerTable.Columns.Add( _
New DataColumn("CustomerID", GetType(Integer)))
' Populate the Customer table.
For i=1 To 5
TempDataRow = CustomerTable.NewRow()
TempDataRow(0) = "Customer " & i.ToString()
TempDataRow(1) = (i+1700)
CustomerTable.Rows.Add(TempDataRow)
Next
' Create a DataSet and add the Employee and Customer tables.
Dim ds As DataSet = New DataSet()
ds.Tables.Add(EmployeeTable)
ds.Tables.Add(CustomerTable)
Return ds
End Function
Sub Page_Load(sender As Object, e As EventArgs)
' The data source only needs to be bound to the DataList
' control the first time the page is accessed.
If Not IsPostBack Then
' Create the sample data for the DataList control.
ItemsGrid.DataSource = CreateDataSet()
' The data source in this example contains multiple tables.
' Specify which table to display in the DataList control.
ItemsGrid.DataMember = "Customer"
' Bind the data source to the control.
ItemsGrid.DataBind()
End If
End Sub
Sub Index_Change(sender As Object, e As EventArgs)
' Create the sample data for the DataList control.
ItemsGrid.DataSource = CreateDataSet()
' The data source in this example contains multiple tables.
' Specify which table to display in the DataList control
' based on the user's selection from the DropDownList control.
ItemsGrid.DataMember = SourceList.SelectedItem.Text
' Bind the data source to the control.
ItemsGrid.DataBind()
End Sub
</script>
</head>
<body>
<form runat="server">
<h3> BaseDataList DataMember Example </h3>
<asp:DataGrid id="ItemsGrid"
AutoGenerateColumns="True"
runat="server">
<HeaderStyle BackColor="#00aaaa"/>
</asp:DataGrid>
<br><br>
Select the data source: <br>
<asp:DropDownList id="SourceList"
AutoPostBack="True"
OnSelectedIndexChanged="Index_Change"
runat="server">
<asp:Listitem Selected="True">Customer</asp:Listitem>
<asp:Listitem>Employee</asp:Listitem>
</asp:DropDownList>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace = "System.Data" %>
<html>
<head>
<script runat="server">
// Create sample data for the DataGrid control with two tables,
// Employee and Customer.
DataSet CreateDataSet()
{
// Create a table to store employee values.
DataTable EmployeeTable = new DataTable("Employee");
DataRow TempDataRow;
// Define the columns for the Employee table.
EmployeeTable.Columns.Add(
new DataColumn("EmployeeName", typeof(string)));
EmployeeTable.Columns.Add(
new DataColumn("EmployeeID", typeof(int)));
// Populate the Employee table.
for (int i=1; i<=5; i++)
{
TempDataRow = EmployeeTable.NewRow();
TempDataRow[0] = "Employee " + i.ToString();
TempDataRow[1] = (i+1700);
EmployeeTable.Rows.Add(TempDataRow);
}
// Create a table to store customer values.
DataTable CustomerTable = new DataTable("Customer");
// Define the columns for the Customer table.
CustomerTable.Columns.Add(
new DataColumn("CustomerName", typeof(string)));
CustomerTable.Columns.Add(
new DataColumn("CustomerID", typeof(int)));
// Populate the Customer table.
for (int i=1; i<=5; i++)
{
TempDataRow = CustomerTable.NewRow();
TempDataRow[0] = "Customer " + i.ToString();
TempDataRow[1] = (i+1700);
CustomerTable.Rows.Add(TempDataRow);
}
// Create a DataSet and add the Employee and Customer tables.
DataSet ds = new DataSet();
ds.Tables.Add(EmployeeTable);
ds.Tables.Add(CustomerTable);
return ds;
}
void Page_Load(Object sender, EventArgs e)
{
// The data source only needs to be bound to the DataList
// control the first time the page is accessed.
if(!IsPostBack)
{
// Create the sample data for the DataList control.
ItemsGrid.DataSource = CreateDataSet();
// The data source in this example contains multiple tables.
// Specify which table to display in the DataList control.
ItemsGrid.DataMember = "Customer";
// Bind the data source to the control.
ItemsGrid.DataBind();
}
}
void Index_Change(Object sender, EventArgs e)
{
// Create the sample data for the DataList control.
ItemsGrid.DataSource = CreateDataSet();
// The data source in this example contains multiple tables.
// Specify which table to display in the DataList control
// based on the user's selection from the DropDownList control.
ItemsGrid.DataMember = SourceList.SelectedItem.Text;
// Bind the data source to the control.
ItemsGrid.DataBind();
}
</script>
</head>
<body>
<form runat="server">
<h3> BaseDataList DataMember Example </h3>
<asp:DataGrid id="ItemsGrid"
AutoGenerateColumns="True"
runat="server">
<HeaderStyle BackColor="#00aaaa"/>
</asp:DataGrid>
<br><br>
Select the data source: <br>
<asp:DropDownList id="SourceList"
AutoPostBack="True"
OnSelectedIndexChanged="Index_Change"
runat="server">
<asp:Listitem Selected="True">Customer</asp:Listitem>
<asp:Listitem>Employee</asp:Listitem>
</asp:DropDownList>
</form>
</body>
</html>
Windows 98、Windows 2000 SP4、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。
.NET Framework
受以下版本支持：2.0、1.1、1.0