DataGridView.DataMember Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece el nombre de la lista o tabla del origen de datos cuyos datos se están mostrando en DataGridView.

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

Nombre de la tabla o lista del objeto DataSource cuyos datos se están mostrando en el control DataGridView. De manera predeterminada, es Empty.

Excepciones

Exception

Se produjo un error en el origen de datos y no hay ningún controlador para el evento DataError o el controlador ha establecido la propiedad ThrowException en true. El objeto de excepción normalmente se puede convertir al tipo FormatException.

Ejemplos

En el ejemplo de código siguiente se muestra un uso común para esta propiedad. En el ejemplo, un DataGridView control denominado customersDataGridView está enlazado a un DataSet denominado customersDataSet. Contiene DataSet una tabla denominada "Customers". La DataMember propiedad se establece en el nombre de la tabla.

private void BindData()
{
    customersDataGridView.AutoGenerateColumns = true;
    customersDataGridView.DataSource = customersDataSet;
    customersDataGridView.DataMember = "Customers";
}

Private Sub BindData()

    With customersDataGridView
        .AutoGenerateColumns = True
        .DataSource = customersDataSet
        .DataMember = "Customers"
    End With

End Sub

Comentarios

Esta propiedad es útil cuando se enlaza a un origen de datos que contiene varias listas o tablas. No es necesario establecer esta propiedad al enlazar a un origen de datos que contenga una sola lista o tabla. Por ejemplo, puede enlazar un DataGridView control a un DataSet objeto que contenga una sola tabla sin establecer esta propiedad. DataSet Sin embargo, si contiene varias tablas, debe establecer esta propiedad en el nombre de una de las tablas.

Consulte también

• DataSource
• DataSet
• DataGridView (Control, formularios Windows Forms)