DataGridView.DataMember Eigenschaft

Definition

Ruft den Namen der Liste oder Tabelle in der Datenquelle auf, für die die DataGridView Daten anzeigt, oder legt den Namen fest.

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

Eigenschaftswert

Der Name der Tabelle oder Liste in der DataSource, für die die DataGridView Daten anzeigt. Der Standardwert ist Empty.

Ausnahmen

In der Datenquelle ist ein Fehler aufgetreten. Entweder ist kein Handler für das DataError-Ereignis vorhanden, oder der Handler hat die ThrowException-Eigenschaft auf true festgelegt. Das Ausnahmeobjekt kann in der Regel in den Typ FormatException umgewandelt werden.

Beispiele

Das folgende Codebeispiel veranschaulicht eine allgemeine Verwendung für diese Eigenschaft. Im Beispiel ist ein DataGridView Steuerelement mit dem Namen customersDataGridView an ein benanntes customersDataSetDataSet gebunden. Diese DataSet enthält eine Tabelle mit dem Namen "Customers". Die DataMember -Eigenschaft ist auf den Namen der Tabelle festgelegt.

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

Hinweise

Diese Eigenschaft ist nützlich, wenn Sie an eine Datenquelle binden, die mehrere Listen oder Tabellen enthält. Sie müssen diese Eigenschaft nicht festlegen, wenn Sie an eine Datenquelle binden, die eine einzelne Liste oder Tabelle enthält. Beispielsweise können Sie ein Steuerelement an ein DataGridViewDataSet binden, das eine einzelne Tabelle enthält, ohne diese Eigenschaft festzulegen. Wenn die DataSet jedoch mehrere Tabellen enthält, müssen Sie diese Eigenschaft auf den Namen einer der Tabellen festlegen.

Gilt für:

Weitere Informationen