DataGrid.DataMember 属性
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取或设置 DataSource 中的特定列表，DataGrid 控件为该数据源显示网格。
public:
property System::String ^ DataMember { System::String ^ get(); void set(System::String ^ value); };public string DataMember { get; set; }member this.DataMember : string with get, setPublic Property DataMember As String属性值
DataSource 中的一个列表。 默认值为空字符串("")。
示例
下面的代码示例设置DataSource控件的System.Windows.Forms.DataGrid和DataMember属性。
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.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);
}
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
注解
如果包含 DataSource 多个数据源，则应将它设置为 DataMember 其中一个源。 例如，如果DataSource它是一个或包含名为三个DataSetDataViewManager表的表Customers``Orders，并且OrderDetails必须指定要绑定到的表之一。 DataSet如果只DataViewManager包含一个DataTable，则应将它设置为DataMemberTableName该DataTable属性。
如果设置为DataSourceDataSet包含DataRelation对象的表，父表将显示加号 (+) 每行标题。 单击加号会导致显示包含子表链接的节点。 例如，如果一个包含两个DataSet命名Customers的对象，并且Orders设置DataMember该Customers表会导致System.Windows.Forms.DataGrid显示一个父表，并在每行标题上DataTable显示加号。 但是，如果设置为DataMemberOrders空，则行标题将为空。
DataSource如果为 、DataTableDataView、集合或数组，则DataMember设置属性将引发异常。
备注
在运行时，必须使用 SetDataBinding 该方法重置 DataSource 属性。 但是， DataMember 只能将属性重置为有效的表名称。