DataGridView.DataMember Vlastnost

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Získá nebo nastaví název seznamu nebo tabulky ve zdroji dat, pro který DataGridView je zobrazen data.

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

Hodnota vlastnosti

String

Název tabulky nebo seznamu v seznamu DataSource , pro který DataGridView se zobrazují data. Výchozí formát je Empty.

Výjimky

Exception

Ve zdroji dat došlo k chybě a pro událost neexistuje žádná obslužná rutina DataError nebo obslužná rutina nastavila ThrowException vlastnost na true. Objekt výjimky lze obvykle přetypovat na typ FormatException.

Příklady

Následující příklad kódu ukazuje běžné použití této vlastnosti. V tomto příkladu DataGridView je ovládací prvek s názvem customersDataGridView svázán s DataSet názvem customersDataSet. Obsahuje DataSet tabulku s názvem Customers (Zákazníci). Vlastnost DataMember je nastavená na název tabulky.

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

Poznámky

Tato vlastnost je užitečná při vytváření vazby na zdroj dat, který obsahuje více seznamů nebo tabulek. Tuto vlastnost nemusíte nastavovat při vytváření vazby na zdroj dat, který obsahuje jeden seznam nebo tabulku. Můžete například svázat DataGridView ovládací prvek s objektem DataSet , který obsahuje jednu tabulku, aniž byste tuto vlastnost nastavili. Pokud však objekt DataSet obsahuje více tabulek, musíte tuto vlastnost nastavit na název jedné z tabulek.

Platí pro

Viz také