DataGridView.DataMember Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

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

String

Nazwa tabeli lub listy, DataSource dla której DataGridView są wyświetlane dane. Wartość domyślna to Empty.

Wyjątki

Exception

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 customersDataSetelementem 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.

Dotyczy

Zobacz też