DataGrid.DataMember Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtém ou define a lista específica em uma DataSource para o qual o controle DataGrid exibe uma grade.

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

Valor da propriedade

String

Uma lista em um DataSource. O padrão é uma cadeia de caracteres vazia ("").

Exemplos

O exemplo de código a seguir define as propriedades e DataMember as DataSource propriedades de um System.Windows.Forms.DataGrid controle.

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

Comentários

Se uma DataSource contiver várias fontes de dados, você deverá definir como DataMember uma das fontes. Por exemplo, se o DataSource é um DataSet ou DataViewManager que contém três tabelas nomeadas Customers``OrderseOrderDetails, você deve especificar uma das tabelas a serem associadas. Se o DataSet ou DataViewManager contiver apenas umDataTable, você deverá definir o TableName DataMember valor para issoDataTable.

Se o DataSource valor for definido como um DataSet que contém DataRelation objetos, as tabelas pai aparecerão com um sinal de adição (+) em cada cabeçalho de linha. Clicar no sinal de adição faz com que um nó apareça que contém links para tabelas filho. Por exemplo, se um DataSet contém dois DataTable objetos nomeados Customers e Orders, definir a DataMember Customers tabela faz com que a System.Windows.Forms.DataGrid tabela pai exiba uma tabela pai com um sinal de adição visível em cada cabeçalho de linha. No entanto, se o DataMember valor for definido como Orders, os cabeçalhos de linha ficarão em branco.

Se for DataSource uma DataTable, coleção DataViewou matriz, a configuração da DataMember propriedade gerará uma exceção.

Observação

Em tempo de execução, você deve usar o SetDataBinding método para redefinir a DataSource propriedade. No entanto, somente a DataMember propriedade pode ser redefinida a qualquer momento para um nome de tabela válido.

Aplica-se a

Confira também