BaseDataList.DataMember-Eigenschaft
Ruft in einer Datenquelle mit mehreren Membern einen bestimmten Datenmember ab, der an ein Datenauflistungssteuerelement gebunden werden soll, oder legt diesen fest.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
<ThemeableAttribute(False)> _
Public Property DataMember As String
'Usage
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)
Eigenschaftenwert
Ein Datenmember aus einer Datenquelle mit mehreren Membern. Der Standardwert ist String.Empty.
Hinweise
Mit der DataMember-Eigenschaft geben Sie in einer Datenquelle mit mehreren Membern einen Member an, der an das Datenlistensteuerelement gebunden werden soll. Wenn z. B. in der DataSource-Eigenschaft eine Datenquelle mit mehreren Tabellen angegeben ist, geben Sie mit der DataMember-Eigenschaft an, welche Tabelle an das Datenauflistungssteuerelement gebunden werden soll.
Diese Eigenschaft kann nicht von Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und Übersicht über ASP.NET-Designs und ASP.NET-Skins.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie mit der DataMember-Eigenschaft angegeben wird, welche Tabelle in einem DataSet-Objekt an ein DataGrid-Steuerelement gebunden werden soll.
<%@ 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>
Plattformen
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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
BaseDataList-Klasse
BaseDataList-Member
System.Web.UI.WebControls-Namespace
DataSource