DataGridView.DataMember Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia nazwę listy lub tabeli w źródle danych, dla którego DataGridView są wyświetlane dane.
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
Wartość właściwości
Nazwa tabeli lub listy, DataSource dla której DataGridView są wyświetlane dane. Wartość domyślna to Empty.
Wyjątki
Wystąpił błąd w źródle danych i nie ma procedury obsługi dla DataError zdarzenia lub program obsługi ustawił ThrowException właściwość na true
. Obiekt wyjątku może być zwykle rzutowy do typu FormatException.
Przykłady
Poniższy przykład kodu ilustruje typowe zastosowanie tej właściwości. W tym przykładzie kontrolka DataGridView o nazwie customersDataGridView
jest powiązana z nazwanym customersDataSet
elementem DataSet . Zawiera DataSet tabelę o nazwie "Customers". Właściwość DataMember jest ustawiona na nazwę tabeli.
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
Uwagi
Ta właściwość jest przydatna podczas tworzenia powiązania ze źródłem danych zawierającym wiele list lub tabel. Nie trzeba ustawiać tej właściwości podczas tworzenia powiązania ze źródłem danych zawierającym jedną listę lub tabelę. Na przykład możesz powiązać kontrolkę z kontrolką DataGridViewDataSet zawierającą jedną tabelę bez ustawiania tej właściwości. Jeśli jednak zawiera DataSet wiele tabel, należy ustawić tę właściwość na nazwę jednej z tabel.