DataGrid.DataMember Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de specifieke lijst op of stelt u deze in in een DataSource lijst waarin het DataGrid besturingselement een raster weergeeft.
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 StringWaarde van eigenschap
Een lijst in een DataSource. De standaardwaarde is een lege tekenreeks ("").
Voorbeelden
In het volgende codevoorbeeld worden de eigenschappen DataSource en DataMember van een besturingselement System.Windows.Forms.DataGrid ingesteld.
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
Opmerkingen
Als een gegevensbron DataSource meerdere gegevensbronnen bevat, moet u het DataMember instellen op een van de bronnen. Als de tabel bijvoorbeeld een DataSource of drie tabellen bevat met de DataSet naam DataViewManager, Customersen Ordersmoet u een van de tabellen opgeven waarmee u een binding wilt OrderDetails maken. Als de DataSet of DataViewManager slechts één DataTablebevat, moet u de DataMember waarde TableName ervan DataTableinstellen.
Als de DataSource waarde is ingesteld op een DataSet object dat objecten bevat DataRelation , worden bovenliggende tabellen weergegeven met een plusteken (+) in elke rijkop. Als u op het plusteken klikt, wordt een knooppunt weergegeven dat koppelingen naar onderliggende tabellen bevat. Als een DataSet bijvoorbeeld twee DataTable objecten bevat met de naam Customers en Orders, zorgt u ervoor dat de DataMember wordt ingesteld op de Customers tabel, waardoor de System.Windows.Forms.DataGrid een bovenliggende tabel met een plusteken zichtbaar is voor elke rijkop. Als de DataMember waarde is ingesteld op Orders, zijn de rijkoppen echter leeg.
Als het DataSource een DataTable, verzameling DataViewof matrix is, genereert het instellen van de DataMember eigenschap een uitzondering.
Note
Tijdens runtime moet u de SetDataBinding methode gebruiken om de DataSource eigenschap opnieuw in te stellen. De DataMember eigenschap kan echter op elk gewenst moment opnieuw worden ingesteld op een geldige tabelnaam.
