DataGridView.DataMember Proprietà

Definizione

Ottiene o imposta il nome della tabella o dell'elenco nell'origine dati di cui vengono visualizzati i dati nell'oggetto 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

Valore della proprietà

Nome della tabella o dell'elenco in DataSource di cui vengono visualizzati i dati nell'oggetto DataGridView. Il valore predefinito è Empty.

Eccezioni

Si è verificato un errore nell'origine dati. Il gestore per l'evento DataError non esiste oppure la proprietà ThrowException del gestore è impostata su true. In genere è possibile eseguire il cast dell'oggetto eccezione al tipo FormatException.

Esempio

Nell'esempio di codice seguente viene illustrato un uso comune per questa proprietà. Nell'esempio un DataGridView controllo denominato customersDataGridView è associato a un DataSet oggetto denominato customersDataSet. Contiene DataSet una tabella denominata "Clienti". La DataMember proprietà è impostata sul nome della tabella.

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

Commenti

Questa proprietà è utile quando si associa a un'origine dati contenente più elenchi o tabelle. Non è necessario impostare questa proprietà quando si esegue l'associazione a un'origine dati contenente un singolo elenco o una tabella. Ad esempio, è possibile associare un DataGridView controllo a un DataSet che contiene una singola tabella senza impostare questa proprietà. Se l'oggetto DataSet contiene più tabelle, tuttavia, è necessario impostare questa proprietà sul nome di una delle tabelle.

Si applica a

Vedi anche