DataGrid.DataMember Propiedad

Definición

Obtiene o establece la lista especificada en un DataSource para el cual el control DataGrid muestra una cuadrícula.Gets or sets the specific list in a DataSource for which the DataGrid control displays a grid.

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

Lista en una propiedad DataSource.A list in a DataSource. El valor predeterminado es una cadena vacía ("").The default is an empty string ("").

Ejemplos

En el ejemplo de código siguiente se establecen las propiedades DataSource y DataMember de un control System.Windows.Forms.DataGrid.The following code example sets the DataSource and DataMember properties of a 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 un DataSource contiene varios orígenes de datos, debe establecer el DataMember en uno de los orígenes.If a DataSource contains multiple sources of data, you should set the DataMember to one of the sources. Por ejemplo, si el DataSource es un DataSet o DataViewManager que contiene tres tablas denominadas Customers, Orders y OrderDetails, debe especificar una de las tablas a las que se va a enlazar.For example, if the DataSource is a DataSet or DataViewManager that contains three tables named Customers, Orders, and OrderDetails, you must specify one of the tables to bind to. Si el DataSet o DataViewManager solo contiene un @no__t 2, debe establecer el DataMember en el TableName de ese DataTable.If the DataSet or DataViewManager contains only one DataTable, you should set the DataMember to the TableName of that DataTable.

Si el DataSource se establece en un DataSet que contiene objetos DataRelation, las tablas primarias aparecerán con un signo más (+) en cada encabezado de fila.If the DataSource is set to a DataSet that contains DataRelation objects, parent tables will appear with a plus sign (+) in each row header. Al hacer clic en el signo más, aparece un nodo que contiene vínculos a las tablas secundarias.Clicking the plus sign causes a node to appear that contains links to child tables. Por ejemplo, si un DataSet contiene dos objetos DataTable denominados Customers y Orders, el establecimiento de DataMember en la tabla Customers hace que System.Windows.Forms.DataGrid muestre una tabla primaria con un signo más visible en cada encabezado de fila.For example, if a DataSet contains two DataTable objects named Customers and Orders, setting the DataMember to the Customers table causes the System.Windows.Forms.DataGrid to display a parent table with a plus sign visible on each row header. Sin embargo, si la DataMember está establecida en Orders, los encabezados de fila estarán en blanco.If the DataMember is set to Orders, however, the row headers will be blank.

Si el DataSource es un DataTable, DataView, una colección o una matriz, al establecer la propiedad DataMember se produce una excepción.If the DataSource is a DataTable, DataView, collection, or array, setting the DataMember property throws an exception.

Nota

En tiempo de ejecución, debe utilizar el método SetDataBinding para restablecer la propiedad DataSource.At run time, you must use the SetDataBinding method to reset the DataSource property. Sin embargo, la propiedad DataMember solo se puede restablecer en cualquier momento a un nombre de tabla válido.However, the DataMember property alone can be reset at any time to a valid table name.

Se aplica a

Consulte también: