다음을 통해 공유


DataGrid.DataMember 속성

정의

DataSource 컨트롤이 표를 표시하는 대상 DataGrid에서 특정 목록을 가져오거나 설정합니다.

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의 목록입니다. 기본값은 빈 문자열("")입니다.

예제

다음 코드 예제에서는 컨트롤의 DataSource 속성 및 DataMember 설정 합니다 System.Windows.Forms.DataGrid .

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 해야 합니다. 예를 들어 이름이 3개인 테이블 Customers``Orders``OrderDetails또는 DataViewManager DataSet 테이블이 있는 경우 DataSource 바인딩할 테이블 중 하나를 지정해야 합니다. DataSet 하나만 DataTable포함하거나 DataViewManager 포함하는 경우 해당 항목으로 DataMember TableName DataTable설정해야 합니다.

개체가 DataSource 포함된 DataRelation 값으로 DataSet 설정된 경우 부모 테이블은 각 행 머리글에 더하기 기호(+)와 함께 표시됩니다. 더하기 기호를 클릭하면 자식 테이블에 대한 링크가 포함된 노드가 나타납니다. 예를 들어 명명된 두 개체가 포함된 경우 테이블로 Customers 설정 DataMember 하면 DataSet System.Windows.Forms.DataGrid 각 행 머리글에 더하기 기호가 표시된 부모 테이블이 표시됩니다.DataTable Orders``Customers DataMember 그러나 행 머리글이 Orders비어 있는 경우

이 값이 DataSource DataTable, 컬렉션 DataView또는 배열이면 속성을 설정 DataMember 하면 예외가 throw됩니다.

참고

런타임에 이 메서드를 SetDataBinding 사용하여 속성을 다시 설정 DataSource 해야 합니다. 그러나 DataMember 속성만 언제든지 유효한 테이블 이름으로 다시 설정할 수 있습니다.

적용 대상

추가 정보