DataGrid.DataMember Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define a lista específica em a DataSource para a qual o DataGrid controlo apresenta uma grelha.
public:
property System::String ^ DataMember { System::String ^ get(); void set(System::String ^ value); };public string DataMember { get; set; }member this.DataMember : string with get, setPublic Property DataMember As StringValor de Propriedade
Uma lista num DataSource. O padrão é uma cadeia vazia ("").
Exemplos
O seguinte exemplo de código define as propriedades DataSource e DataMember de um controlo 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
Observações
Se a DataSource contiver múltiplas fontes de dados, deve definir o DataMember para uma das fontes. Por exemplo, se for DataSource um DataSet ou DataViewManager que contiver três tabelas chamadas Customers, Orders, e OrderDetails, deve especificar uma das tabelas a associar. Se o DataSet ou DataViewManager contiver apenas um DataTable, deve definir o DataMember para o TableName de que DataTable.
Se o DataSource estiver definido para a DataSet que contém DataRelation objetos, as tabelas pais aparecerão com um sinal de mais (+) em cada cabeçalho de linha. Ao clicar no sinal de mais, aparece um nó que contém ligações para tabelas filhas. Por exemplo, se um DataSet contiver dois objetos DataTable chamados Customers e Orders, definir o DataMember para a tabela Customers faz com que o System.Windows.Forms.DataGrid exiba uma tabela mãe com um sinal de mais visível em cada cabeçalho da linha. Se o DataMember for definido para Orders, no entanto, os cabeçalhos da linha ficarão em branco.
Se for DataSource uma DataTable, DataView, coleção ou array, definir a DataMember propriedade cria uma exceção.
Note
Em tempo de execução, deve usar o SetDataBinding método para reiniciar a DataSource propriedade. No entanto, a DataMember propriedade por si só pode ser reimposta a qualquer momento para um nome de tabela válido.