DataGridView.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 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
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
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.