DataGridView.DataMember Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property DataMember As StringEigenschaftswert
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.
