Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Hinweis
Die DataSet Klassen und verwandten Klassen sind ältere .NET Framework-Technologien aus den frühen 2000er Jahren, mit denen Anwendungen mit Daten im Arbeitsspeicher arbeiten können, während die Apps von der Datenbank getrennt sind. Die Technologien sind besonders nützlich für Apps, mit denen Benutzer Daten ändern und die Änderungen wieder in der Datenbank speichern können. Obwohl Datasets eine bewährte erfolgreiche Technologie sind, ist der empfohlene Ansatz für neue .NET-Anwendungen die Verwendung von Entity Framework Core. Entity Framework bietet eine natürlichere Möglichkeit zum Arbeiten mit tabellarischen Daten als Objektmodelle und verfügt über eine einfachere Programmierschnittstelle.
Sie können Daten in Objekten in einer Datenbank speichern, indem Sie die Werte aus Ihrem Objekt an eine der DBDirect-Methoden von TableAdapter übergeben (z. B TableAdapter.Insert. ). Weitere Informationen finden Sie unter TableAdapter.
Um Daten aus einer Auflistung von Objekten zu speichern, durchlaufen Sie die Auflistung von Objekten (z. B. eine for-next-Schleife), und senden Sie die Werte für jedes Objekt mithilfe einer der Methoden von TableAdapter DBDirect an die Datenbank.
Standardmäßig werden DBDirect-Methoden für eine TableAdapter-Instanz erstellt, die direkt für die Datenbank ausgeführt werden kann. Diese Methoden können direkt aufgerufen werden und erfordern weder DataSet- noch DataTable-Objekte, um Änderungen zu konsolidieren und Aktualisierungen an eine Datenbank zu senden.
Hinweis
Um einen TableAdapter zu konfigurieren, muss die Hauptabfrage genügend Informationen bereitstellen, damit die DBDirect Methoden erstellt werden können. Wenn beispielsweise ein TableAdapter so konfiguriert ist, dass Daten aus einer Tabelle abgerufen werden, die keine Primärschlüsselspalte definiert hat, werden keine Methoden generiert DBDirect .
| TableAdapter DBDirect-Methode | BESCHREIBUNG |
|---|---|
TableAdapter.Insert |
Fügt einer Datenbank neue Datensätze hinzu und ermöglicht es Ihnen, einzelne Spaltenwerte als Methodenparameter zu übergeben. |
TableAdapter.Update |
Aktualisiert vorhandene Datensätze in einer Datenbank. Die Update Methode verwendet ursprüngliche und neue Spaltenwerte als Methodenparameter. Die ursprünglichen Werte werden verwendet, um den ursprünglichen Datensatz zu finden, und die neuen Werte werden verwendet, um diesen Datensatz zu aktualisieren.Die TableAdapter.Update Methode wird auch verwendet, um Änderungen in einem Dataset wieder mit der Datenbank abzugleichen, indem ein DataSet, DataTable, , DataRowoder ein Array von DataRows als Methodenparameter verwendet wird. |
TableAdapter.Delete |
Löscht vorhandene Datensätze aus der Datenbank basierend auf den ursprünglichen Spaltenwerten, die als Methodenparameter übergeben werden. |
So speichern Sie neue Datensätze aus einem Objekt in einer Datenbank
Erstellen Sie die Datensätze, indem Sie die Werte an die
TableAdapter.InsertMethode übergeben.Im folgenden Beispiel wird ein neuer Kundendatensatz in der
CustomersTabelle erstellt, indem die Werte imcurrentCustomerObjekt an dieTableAdapter.InsertMethode übergeben werden.private void AddNewCustomers(Customer currentCustomer) { customersTableAdapter.Insert( currentCustomer.CustomerID, currentCustomer.CompanyName, currentCustomer.ContactName, currentCustomer.ContactTitle, currentCustomer.Address, currentCustomer.City, currentCustomer.Region, currentCustomer.PostalCode, currentCustomer.Country, currentCustomer.Phone, currentCustomer.Fax); }
So aktualisieren Sie vorhandene Datensätze aus einem Objekt in eine Datenbank
Ändern Sie die Datensätze, indem Sie die
TableAdapter.UpdateMethode aufrufen. Übergeben Sie die neuen Werte, um den Datensatz zu aktualisieren, und übergeben Sie die ursprünglichen Werte, um den Datensatz zu lokalisieren.Hinweis
Ihr Objekt muss die ursprünglichen Werte beibehalten, um sie an die
UpdateMethode zu übergeben. In diesem Beispiel werden Eigenschaften mit einemorigPräfix verwendet, um die ursprünglichen Werte zu speichern.Im folgenden Beispiel wird ein vorhandener Datensatz in der
CustomersTabelle aktualisiert, indem die neuen und ursprünglichen Werte imCustomerObjekt an dieTableAdapter.UpdateMethode übergeben werden.private void UpdateCustomer(Customer cust) { customersTableAdapter.Update( cust.CustomerID, cust.CompanyName, cust.ContactName, cust.ContactTitle, cust.Address, cust.City, cust.Region, cust.PostalCode, cust.Country, cust.Phone, cust.Fax, cust.origCustomerID, cust.origCompanyName, cust.origContactName, cust.origContactTitle, cust.origAddress, cust.origCity, cust.origRegion, cust.origPostalCode, cust.origCountry, cust.origPhone, cust.origFax); }
So löschen Sie vorhandene Datensätze aus einer Datenbank
Löschen Sie die Datensätze, indem Sie die
TableAdapter.DeleteMethode aufrufen und die ursprünglichen Werte übergeben, um den Datensatz zu suchen.Hinweis
Ihr Objekt muss die ursprünglichen Werte beibehalten, um sie an die
DeleteMethode zu übergeben. In diesem Beispiel werden Eigenschaften mit einemorigPräfix verwendet, um die ursprünglichen Werte zu speichern.Im folgenden Beispiel wird ein Datensatz aus der
CustomersTabelle gelöscht, indem die ursprünglichen Werte imCustomerObjekt an die Methode übergeben werdenTableAdapter.Delete.
.NET-Sicherheit
Sie müssen über die Berechtigung zum Ausführen des ausgewählten INSERT-, UPDATE- oder DELETE-Vorgangs für die Tabelle in der Datenbank verfügen.