Freigeben über

Anleitung: So binden Sie ein DataGrid-Steuerelement von Windows Forms an eine Datenquelle

Hinweis

Das DataGridView-Steuerelement ersetzt und fügt dem DataGrid-Steuerelement Funktionen hinzu; Das DataGrid-Steuerelement wird jedoch sowohl für die Abwärtskompatibilität als auch für die zukünftige Verwendung beibehalten, wenn Sie dies auswählen. Weitere Informationen finden Sie unter Unterschiede zwischen dem DataGridView-Steuerelement und dem DataGrid-Steuerelement in Windows Forms.

Das Windows Forms DataGrid-Steuerelement ist speziell für die Anzeige von Informationen aus einer Datenquelle konzipiert. Sie binden das Steuerelement zur Laufzeit, indem Sie die SetDataBinding-Methode aufrufen. Obwohl Sie Daten aus einer Vielzahl von Datenquellen anzeigen können, sind die typischsten Quellen Datasets und Datenansichten.

So binden Sie Daten programmgesteuert an das DataGrid-Steuerelement

  1. Schreiben Sie Code, um das Dataset auszufüllen.

    Wenn es sich bei der Datenquelle um ein Dataset oder eine Datenansicht handelt, die auf einer Datasettabelle basiert, fügen Sie dem Formular Code hinzu, um das Dataset auszufüllen.

    Der genaue Code, den Sie verwenden, hängt davon ab, woher der Datensatz seine Daten bezieht. Wenn das Dataset direkt aus einer Datenbank aufgefüllt wird, rufen Sie in der Regel die Fill Methode eines Datenadapters auf, wie im folgenden Beispiel, das ein Dataset mit dem Namen DsCategories1auffüllt:

    sqlDataAdapter1.Fill(DsCategories1)

    sqlDataAdapter1.Fill(DsCategories1);

    sqlDataAdapter1->Fill(dsCategories1);

    Wenn das Dataset aus einem XML-Webdienst gefüllt wird, erstellen Sie in der Regel eine Instanz des Diensts in Ihrem Code und rufen dann eine seiner Methoden auf, um ein Dataset zurückzugeben. Anschließend integrieren Sie die Daten aus dem XML-Webdienst in Ihren lokalen Datensatz. Das folgende Beispiel zeigt, wie Sie eine Instanz eines XML-Webdiensts namens CategoriesServiceerstellen, dessen GetCategories-Methode aufrufen und das resultierende Dataset in einem lokalen Dataset mit dem Namen DsCategories1zusammenführen können:

    Dim ws As New MyProject.localhost.CategoriesService()
ws.Credentials = System.Net.CredentialCache.DefaultCredentials
DsCategories1.Merge(ws.GetCategories())

    MyProject.localhost.CategoriesService ws = new MyProject.localhost.CategoriesService();
ws.Credentials = System.Net.CredentialCache.DefaultCredentials;
DsCategories1.Merge(ws.GetCategories());

    MyProject::localhost::CategoriesService^ ws =
   new MyProject::localhost::CategoriesService();
ws->Credentials = System::Net::CredentialCache::DefaultCredentials;
dsCategories1->Merge(ws->GetCategories());

  2. Rufen Sie die DataGrid-Methode des SetDataBinding-Steuerelements auf, und übergeben Sie die Datenquelle und ein Datenelement. Wenn Sie ein Datenelement nicht explizit übergeben müssen, übergeben Sie eine leere Zeichenfolge.

    Hinweis

    Bei der ersten Bindung des Rasters können Sie die Eigenschaften DataSource und DataMember des Steuerelements festlegen. Sie können diese Eigenschaften jedoch nicht zurücksetzen, nachdem sie festgelegt wurden. Daher wird empfohlen, immer die SetDataBinding-Methode zu verwenden.

    Das folgende Beispiel zeigt, wie Sie programmgesteuert eine Bindung an die Tabelle "Customers" in einem Dataset namens "DsCustomers1" ausführen können:

    DataGrid1.SetDataBinding(DsCustomers1, "Customers")

    DataGrid1.SetDataBinding(DsCustomers1, "Customers");

    dataGrid1->SetDataBinding(dsCustomers1, "Customers");

    Wenn die Tabelle "Customers" die einzige Tabelle im Dataset ist, können Sie alternativ das Raster auf diese Weise binden:

    DataGrid1.SetDataBinding(DsCustomers1, "")

    DataGrid1.SetDataBinding(DsCustomers1, "");

    dataGrid1->SetDataBinding(dsCustomers1, "");

  3. (Optional) Fügen Sie dem Raster geeignete Tabellen- und Spaltenstile hinzu. Wenn keine Tabellenstile vorhanden sind, wird die Tabelle zwar angezeigt, aber mit minimaler Formatierung, und alle Spalten sind sichtbar.

Siehe auch