DataGridView.DataMember 屬性

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

取得或設定資料來源中，DataGridView 會顯示資料之清單或資料表的名稱。

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

屬性值

String

DataSource 中， DataGridView 會顯示資料之資料表或清單的名稱。 預設為 Empty。

例外狀況

Exception

資料來源發生錯誤，DataError 事件沒有處理常式，或處理常式已將 ThrowException 屬性設定為 true。 例外狀況物件通常可轉換成 FormatException 類型。

範例

下列程式碼範例說明這個屬性的常見用法。 在此範例中， DataGridView 名為 customersDataGridView 的控制項會系結至名為 customersDataSet 的 DataSet 。 這 DataSet 包含名為 「Customers」 的資料表。 屬性 DataMember 會設定為數據表的名稱。

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

備註

當系結至包含多個清單或資料表的資料來源時，這個屬性很有用。 系結至包含單一清單或資料表的資料來源時，您不需要設定此屬性。 例如，您可以將 控制項系結 DataGridView 至 DataSet 包含單一資料表的 ，而不需要設定這個屬性。 DataSet不過，如果 包含多個資料表，您必須將此屬性設定為其中一個資料表的名稱。

另請參閱

• DataSource
• DataSet
• DataGridView 控制項 (Windows Form)