DataGrid.DataMember Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece la lista específica de un DataSource para el que el DataGrid control muestra una cuadrícula.
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 propiedad
Una lista de .DataSource El valor predeterminado es una cadena vacía ("").
Ejemplos
En el ejemplo de código siguiente se establecen las DataSource propiedades y DataMember de un 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
Comentarios
Si contiene DataSource varios orígenes de datos, debe establecer en DataMember uno de los orígenes. Por ejemplo, si DataSource es o DataViewManagerDataSet que contiene tres tablas denominadas Customers, Ordersy OrderDetails, debe especificar una de las tablas a las que enlazar. Si o DataSetDataViewManager contiene solo una DataTable, debe establecer en DataMember el TableName de ese DataTableobjeto .
Si se establece en DataSource un DataSet objeto que contiene DataRelation objetos, las tablas primarias aparecerán con un signo más (+) en cada encabezado de fila. Al hacer clic en el signo más, aparecerá un nodo que contiene vínculos a tablas secundarias. Por ejemplo, si contiene DataSet dos DataTable objetos denominados Customers y Orders, al establecer en DataMember la Customers tabla , se System.Windows.Forms.DataGrid mostrará una tabla primaria con un signo más visible en cada encabezado de fila. Sin embargo, si se establece Ordersen DataMember , los encabezados de fila estarán en blanco.
DataSource Si es , DataTable, DataViewcolección o matriz, al establecer la DataMember propiedad se produce una excepción.
Nota:
En tiempo de ejecución, debe usar el SetDataBinding método para restablecer la DataSource propiedad . Sin embargo, la DataMember propiedad solo se puede restablecer en cualquier momento a un nombre de tabla válido.
