DataGrid.DataMember Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Obtiene o establece la lista especificada en un DataSource para el cual el control DataGrid 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, set
Public Property DataMember As String

Valor de propiedad

String

Lista en un 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

DataSource Si contiene varios orígenes de datos, debe establecer en DataMember uno de los orígenes. Por ejemplo, si DataSource es o DataViewManager DataSet que contiene tres tablas denominadas Customers, Ordersy OrderDetails, debe especificar una de las tablas a las que enlazar. Si el DataSet objeto o DataViewManager contiene solo un DataTable, debe establecer en DataMember el TableName de .DataTable

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, aparece un nodo que contiene vínculos a tablas secundarias. Por ejemplo, si DataSet contiene dos DataTable objetos denominados Customers y Orders, establecer en DataMember la Customers tabla hace que System.Windows.Forms.DataGrid muestre 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 un DataTable, DataView, colecció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 por sí sola se puede restablecer en cualquier momento a un nombre de tabla válido.

Se aplica a

Consulte también