DataGrid.DataMember 속성

정의

DataSource 컨트롤이 표를 표시하는 대상 DataGrid에서 특정 목록을 가져오거나 설정합니다.Gets or sets the specific list in a DataSource for which the DataGrid control displays a grid.

public:
 property System::String ^ DataMember { System::String ^ get(); void set(System::String ^ value); };
public string DataMember { get; set; }
member this.DataMember : string with get, set
Public Property DataMember As String

속성 값

String

DataSource의 목록입니다.A list in a DataSource. 기본값은 빈 문자열("")입니다.The default is an empty string ("").

예제

다음 코드 예제에서는 DataSource 컨트롤의 및 속성을 설정 합니다 DataMember System.Windows.Forms.DataGrid .The following code example sets the DataSource and DataMember properties of a System.Windows.Forms.DataGrid control.

protected:
   Object^ source;

private:
   void SetSourceAndMember()
   {
      DataSet^ myDataSet = gcnew DataSet( "myDataSet" );
      DataTable^ tableCustomers = gcnew DataTable( "Customers" );
      myDataSet->Tables->Add( tableCustomers );
      // Insert code to populate the DataSet.

      // Set DataSource and DataMember with SetDataBinding method.
      String^ member;
      
      // The name of a DataTable is Customers.
      member = "Customers";
      dataGrid1->SetDataBinding( myDataSet, member );
   }
protected object source;

private void SetSourceAndMember(){

   DataSet myDataSet = new DataSet("myDataSet");
   DataTable tableCustomers = new DataTable("Customers");
   myDataSet.Tables.Add(tableCustomers);
   // Insert code to populate the DataSet.

   // Set DataSource and DataMember with SetDataBinding method.
   string member;
   // The name of a DataTable is Customers.
   member = "Customers";
   dataGrid1.SetDataBinding(myDataSet, member);
}

Private Sub SetSourceAndMember()
    Dim myDataSet As DataSet = New DataSet("myDataSet")
    Dim customersTable As DataTable = new DataTable("Customers")
    ' Insert code to set source to populate DataSet.
    
    ' Set DataSource and DataMember with SetDataBinding method.
    Dim member As String
    ' The name of a DataTable is Customers.
    member = "Customers"
    DataGrid1.SetDataBinding(myDataSet, member)
 End Sub

설명

DataSource 데이터 원본이 여러 개 있는 경우를 원본 중 하나로 설정 해야 합니다 DataMember .If a DataSource contains multiple sources of data, you should set the DataMember to one of the sources. 예를 DataSource 들어,가 DataSet 이거나 DataViewManager , 및 라는 3 개의 테이블을 포함 하는 경우 Customers 에는 Orders OrderDetails 바인딩할 테이블 중 하나를 지정 해야 합니다.For example, if the DataSource is a DataSet or DataViewManager that contains three tables named Customers, Orders, and OrderDetails, you must specify one of the tables to bind to. 또는에 하나만 있는 경우를 DataSet DataViewManager DataTable 의로 설정 해야 합니다 DataMember TableName DataTable .If the DataSet or DataViewManager contains only one DataTable, you should set the DataMember to the TableName of that DataTable.

DataSource가 개체를 포함 하는로 설정 된 경우 DataSet DataRelation 부모 테이블은 각 행 머리글에 더하기 기호 (+)가 표시 됩니다.If the DataSource is set to a DataSet that contains DataRelation objects, parent tables will appear with a plus sign (+) in each row header. 더하기 기호를 클릭 하면 자식 테이블에 대 한 링크가 포함 된 노드가 표시 됩니다.Clicking the plus sign causes a node to appear that contains links to child tables. 예를 DataSet 들어에 및 라는 두 개의 개체가 포함 된 경우를 DataTable Customers Orders 테이블로 설정 하면 DataMember Customers 에서 System.Windows.Forms.DataGrid 각 행 머리글에 더하기 기호가 표시 된 부모 테이블을 표시 합니다.For example, if a DataSet contains two DataTable objects named Customers and Orders, setting the DataMember to the Customers table causes the System.Windows.Forms.DataGrid to display a parent table with a plus sign visible on each row header. DataMember그러나가로 설정 된 경우 Orders 행 머리글이 비어 있게 됩니다.If the DataMember is set to Orders, however, the row headers will be blank.

DataSourceDataTable , DataView , 컬렉션 또는 배열인 경우 속성을 설정 하면 DataMember 예외가 throw 됩니다.If the DataSource is a DataTable, DataView, collection, or array, setting the DataMember property throws an exception.

참고

런타임에 메서드를 사용 하 여 속성을 SetDataBinding 다시 설정 해야 합니다 DataSource .At run time, you must use the SetDataBinding method to reset the DataSource property. 그러나 DataMember 언제 든 지 유효한 테이블 이름으로 속성을 다시 설정할 수 있습니다.However, the DataMember property alone can be reset at any time to a valid table name.

적용 대상

추가 정보