DataGridView.DataMember Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

DataGridView.cs

Ottiene o imposta il nome dell'elenco o della tabella nell'origine dati per cui l'oggetto DataGridView visualizza i dati.

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à

String

Nome della tabella o dell'elenco nell'oggetto per il quale l'oggetto DataSourceDataGridView visualizza i dati. Il valore predefinito è Empty.

Eccezioni

Exception

Si è verificato un errore nell'origine dati e non esiste alcun gestore per l'evento DataError o il gestore ha impostato la ThrowException proprietà su true. L'oggetto eccezione può in genere essere eseguito il cast 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 "Customers". 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 esegue il binding a un'origine dati che contiene più elenchi o tabelle. Non è necessario impostare questa proprietà quando si esegue il binding a un'origine dati contenente un singolo elenco o tabella. Ad esempio, è possibile associare un DataGridView controllo a un DataSet che contiene una singola tabella senza impostare questa proprietà. DataSet Se contiene più tabelle, tuttavia, è necessario impostare questa proprietà sul nome di una delle tabelle.

Vedi anche

• DataSource
• DataSet
• Controllo DataGridView (Windows Form)