DataGridView.DataMember Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

DataGridView.cs

Získá nebo nastaví název seznamu nebo tabulky ve zdroji dat, pro který DataGridView se zobrazují 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 DataSource tabulce, pro kterou DataGridView se zobrazují data. Výchozí hodnota je Empty.

Výjimky

Exception

Ve zdroji dat došlo k chybě a buď neexistuje žádná obslužná rutina události 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 znázorňuje běžné použití této vlastnosti. V příkladu je pojmenovaný DataGridViewcustomersDataGridView ovládací prvek svázán s DataSet názvem customersDataSet. Obsahuje DataSet tabulku s názvem Zákazníci. Vlastnost DataMember je nastavena 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 vazbě ke zdroji dat, který obsahuje více seznamů nebo tabulek. Tuto vlastnost není nutné nastavit při vazbě ke zdroji dat, který obsahuje jeden seznam nebo tabulku. Můžete například svázat DataGridView ovládací prvek s DataSet jednou tabulkou bez nastavení této vlastnosti. Pokud však DataSet obsahuje více tabulek, musíte tuto vlastnost nastavit na název jedné z tabulek.

Viz také

• DataSource
• DataSet
• Ovládací prvek DataGridView (Windows Forms)