DataGridView.DataMember Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
Název tabulky nebo seznamu v seznamu DataSource , pro který DataGridView se zobrazují data. Výchozí formát je Empty.
Výjimky
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.