DataGrid.DataMember 属性

获取或设置 DataSource 中的特定列表，System.Windows.Forms.DataGrid 控件为该 DataSource 显示网格。

**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）

语法

声明
Public Property DataMember As String
用法
Dim instance As DataGrid
Dim value As String

value = instance.DataMember

instance.DataMember = value

public string DataMember { get; set; }

public:
property String^ DataMember {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_DataMember ()

/** @property */
public void set_DataMember (String value)

public function get DataMember () : String

public function set DataMember (value : String)

属性值

DataSource 中的一个列表。默认值为空字符串 ("")。

备注

如果某 DataSource 包含多个数据源，则应将 DataMember 设置为这些数据源之一。例如，如果 DataSource 是包含名为 Customers、Orders 和 OrderDetails 的三个表的 DataSet 或 DataViewManager，则必须指定这些表之一以便进行绑定。如果 DataSet 或 DataViewManager 只包含一个 DataTable，则应将 DataMember 设置为该 DataTable 的 TableName。

如果 DataSource 设置为包含 DataRelation 对象的 DataSet，则将显示父表，而且每个行标头中均显示一个加号 (+)。单击加号会显示包含指向子表的链接的节点。例如，如果某 DataSet 包含名为 Customers 和 Orders 的两个 DataTable 对象，则将 DataMember 设置为 Customers 表会使 System.Windows.Forms.DataGrid 显示一个父表，其中每个行标头中均显示一个加号。但是，如果 DataMember 设置为 Orders，则行标头将为空白。

如果 DataSource 是一个 DataTable、DataView、集合或数组，则设置 DataMember 属性将引发异常。

提示

在运行时必须使用 SetDataBinding 方法来重置 DataSource 属性。但是，可以在任何时间单独将 DataMember 属性重置为有效的表名。

示例

下面的代码示例设置某 System.Windows.Forms.DataGrid 控件的 DataSource 和 DataMember 属性。

Private Sub SetSourceAndMember()
    Dim myDataSet As DataSet = New DataSet("myDataSet")
    Dim customersTable As DataTable = new DataTable("Customers")
    ' Insert code to set source to populate DataSet.
    
    ' Set DataSource and DataMember with SetDataBinding method.
    Dim member As String
    ' The name of a DataTable is Customers.
    member = "Customers"
    DataGrid1.SetDataBinding(myDataSet, member)
 End Sub

protected object source;

private void SetSourceAndMember(){

   DataSet myDataSet = new DataSet("myDataSet");
   DataTable tableCustomers = new DataTable("Customers");
   myDataSet.Tables.Add(tableCustomers);
   // Insert code to populate the DataSet.

   // Set DataSource and DataMember with SetDataBinding method.
   string member;
   // The name of a DataTable is Customers.
   member = "Customers";
   dataGrid1.SetDataBinding(myDataSet, member);
}

protected:
   Object^ source;

private:
   void SetSourceAndMember()
   {
      DataSet^ myDataSet = gcnew DataSet( "myDataSet" );
      DataTable^ tableCustomers = gcnew DataTable( "Customers" );
      myDataSet->Tables->Add( tableCustomers );
      // Insert code to populate the DataSet.

      // Set DataSource and DataMember with SetDataBinding method.
      String^ member;
      
      // The name of a DataTable is Customers.
      member = "Customers";
      dataGrid1->SetDataBinding( myDataSet, member );
   }

protected Object source;

private void SetSourceAndMember()
{
    DataSet myDataSet = new DataSet("myDataSet");
    DataTable tableCustomers = new DataTable("Customers");
    myDataSet.get_Tables().Add(tableCustomers);
    // Insert code to populate the DataSet.

    // Set DataSource and DataMember with SetDataBinding method.
    String member;
    // The name of a DataTable is Customers.
    member = "Customers";
    dataGrid1.SetDataBinding(myDataSet, member);
} //SetSourceAndMember

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

请参见

参考

DataGrid 类
DataGrid 成员
System.Windows.Forms 命名空间
DataSource
DataSet
DataViewManager
SetDataBinding