ListObject.DataMember 속성 (2007 시스템)

아티클
08/22/2008

업데이트: 2007년 11월

다중 멤버 데이터 소스에서 ListObject 컨트롤에 바인딩할 특정 데이터 멤버를 가져오거나 설정합니다.

네임스페이스: Microsoft.Office.Tools.Excel
어셈블리: Microsoft.Office.Tools.Excel.v9.0(Microsoft.Office.Tools.Excel.v9.0.dll)

구문

Public Property DataMember As String

Dim instance As ListObject
Dim value As String

value = instance.DataMember

instance.DataMember = value

public string DataMember { get; set; }

속성 값

형식: System.String

다중 멤버 데이터 소스의 데이터 멤버입니다. 기본값은 Empty입니다.

설명

데이터 소스에 멤버가 하나만 있는 경우에는 필요하지 않습니다.

DataMember 속성을 사용하여 다중 멤버 데이터 소스에서 ListObject 컨트롤에 바인딩할 멤버를 지정할 수 있습니다. 예를 들어, DataSource 속성에 테이블이 두 개 이상 있는 데이터 소스를 지정한 경우 DataMember 속성을 사용하여 ListObject 컨트롤에 바인딩할 테이블을 지정합니다.

예제

다음 코드 예제에서는 DataTable 개체가 두 개 있는 DataSet을 만들고 테이블 중 하나를 데이터로 채웁니다. 그런 다음 코드에서 ListObject의 DataSource 및 DataMember 속성을 사용하여 데이터가 들어 있는 테이블에 바인딩합니다.

이 예제는 문서 수준 사용자 지정을 위한 것입니다.

Private Sub ListObject_DataSourceAndMember()
    ' Create a DataSet and two DataTables.
    Dim ordersDataSet As New DataSet("ordersDataSet")
    Dim tableCustomers As New DataTable("Customers")
    Dim tableProducts As New DataTable("Products")
    ordersDataSet.Tables.Add(tableCustomers)
    ordersDataSet.Tables.Add(tableProducts)

    ' Add a data to the Customers DataTable.
    tableCustomers.Columns.Add(New DataColumn("LastName"))
    tableCustomers.Columns.Add(New DataColumn("FirstName"))
    Dim dr As DataRow = tableCustomers.NewRow()
    dr("LastName") = "Chan"
    dr("FirstName") = "Gareth"
    tableCustomers.Rows.Add(dr)

    ' Create a list object.
    Dim List1 As Microsoft.Office.Tools.Excel.ListObject = _
        Me.Controls.AddListObject(Me.Range( _
        "A1"), "Customers")

    ' Bind the list object to the Customers table.
    List1.AutoSetDataBoundColumnHeaders = True
    List1.DataSource = ordersDataSet
    List1.DataMember = "Customers"

End Sub

private void ListObject_DataSourceAndMember()
{
    // Create a DataSet and two DataTables.
    DataSet ordersDataSet = new DataSet("ordersDataSet");
    DataTable tableCustomers = new DataTable("Customers");
    DataTable tableProducts = new DataTable("Products");
    ordersDataSet.Tables.Add(tableCustomers);
    ordersDataSet.Tables.Add(tableProducts);

    // Add a data to the Customers DataTable.
    tableCustomers.Columns.Add(new DataColumn("LastName"));
    tableCustomers.Columns.Add(new DataColumn("FirstName"));
    DataRow dr = tableCustomers.NewRow();
    dr["LastName"] = "Chan";
    dr["FirstName"] = "Gareth";
    tableCustomers.Rows.Add(dr);

    // Create a list object.
    Microsoft.Office.Tools.Excel.ListObject list1 = 
        this.Controls.AddListObject(
        this.Range["A1", missing], "Customers");

    // Bind the list object to the Customers table.
    list1.AutoSetDataBoundColumnHeaders = true;
    list1.DataSource = ordersDataSet;
    list1.DataMember = "Customers";
}