Markieren Sie das Kontrollkästchen Englisch, um die englische Version dieses Artikels anzuzeigen. Sie können den englischen Text auch in einem Popup-Fenster einblenden, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Generieren von Befehlen mit 'CommandBuilder'-Objekten

 

Wenn die SelectCommand-Eigenschaft dynamisch zur Laufzeit angegeben wird, z. B. mit einem Abfragetool, in dem der Benutzer einen Textbefehl eingibt, sind Sie zur Entwurfszeit u. U. nicht in der Lage, den entsprechenden InsertCommand, UpdateCommand oder DeleteCommand anzugeben. Wenn Ihre DataTable einer einzelnen Datenbanktabelle zugeordnet ist oder aus einer solchen generiert wurde, können Sie mithilfe des DbCommandBuilder-Objekts automatisch den DeleteCommand, den InsertCommand und den UpdateCommand des DbDataAdapter generieren.

Damit die automatische Befehlsgenerierung funktioniert, muss mindestens die SelectCommand-Eigenschaft festgelegt werden. Das durch die SelectCommand-Eigenschaft abgerufene Tabellenschema bestimmt die Syntax der automatisch generierten INSERT-, UPDATE- und DELETE-Anweisungen.

Der DbCommandBuilder muss SelectCommand ausführen, damit die zum Konstruieren der SQL-Befehle INSERT, UPDATE und DELETE erforderlichen Metadaten zurückgegeben werden. Daher ist ein erneutes Lesen der Datenquelle erforderlich, was die Leistung herabsetzen kann. Eine optimale Leistung lässt sich erzielen, indem Sie die Befehle direkt angeben, anstatt den DbCommandBuilder zu verwenden.

Der SelectCommand muss außerdem mindestens einen Primärschlüssel oder eine eindeutige Spalte zurückgeben. Wenn weder das eine noch das andere vorhanden ist, wird eine InvalidOperation-Ausnahme ausgelöst, und die Befehle werden nicht generiert.

Bei einer Zuordnung zu einem DataAdapter generiert der DbCommandBuilder automatisch die Eigenschaften InsertCommand, UpdateCommand und DeleteCommand des DataAdapter, sofern es sich um NULL-Verweise handelt. Wenn für eine Eigenschaft bereits ein Command vorhanden ist, wird der vorhandene Command verwendet.

Datenbankansichten, die durch das Verknüpfen von zwei oder mehr Datenbanken erstellt wurden, werden nicht als eine einzelne Datenbanktabelle betrachtet. In dieser Instanz können Sie den DbCommandBuilder nicht zum automatischen Generieren von Befehlen verwenden; Sie müssen die Befehle explizit angeben. Informationen, wie Sie explizit Befehle zum Aktualisieren der Datenquelle mit DataSet-Änderungen festlegen können, finden Sie unter Aktualisieren von Datenquellen mit DataAdapters.

Unter Umständen möchten Sie der aktualisierten Zeile eines DataSet erneut Ausgabeparameter zuordnen. Eine allgemeine Aufgabe wäre das Abrufen des Werts eines automatisch generierten Identitätsfelds oder Timestamps aus der Datenquelle. Standardmäßig werden den Spalten in einer aktualisierten Zeile vom DbCommandBuilder keine Ausgabeparameter zugeordnet. In diesem Fall müssen Sie den Befehl explizit angeben. Ein Beispiel für das erneute Zuordnen eines automatisch generierten Identitätsfelds zu einer Spalte einer eingefügten Zeile finden Sie unter Abrufen von Identitäts- oder AutoWert-Werten.

Die folgende Tabelle enthält die Regeln für das Generieren von automatisch generierten Befehlen.

Befehl

Regel

InsertCommand

Fügt in der Datenquelle für alle Zeilen in der Tabelle, die den RowStateAdded aufweisen, eine Zeile ein. Fügt Werte für alle Spalten ein, die aktualisiert werden können (jedoch nicht für Spalten wie Identitäten, Ausdrücke oder Timestamps).

UpdateCommand

Aktualisiert Zeilen in der Datenquelle für alle Zeilen in der Tabelle, die den RowState-Wert Modified aufweisen. Aktualisiert die Werte aller Spalten mit Ausnahme von Spalten, die nicht aktualisiert werden können, z. B. Identitäten oder Ausdrücke. Aktualisiert alle Zeilen, deren Spaltenwerte in der Datenquelle den Primärschlüssel-Spaltenwerten der Zeile entsprechen und bei denen die übrigen Spalten in der Datenquelle den ursprünglichen Werten der Zeile entsprechen. Weitere Informationen finden Sie unter "Vollständiges Parallelitätsmodell für Updates und Löschvorgänge" weiter unten in diesem Thema.

DeleteCommand

Löscht Zeilen in der Datenquelle für alle Zeilen in der Tabelle, die den RowState-Wert Deleted aufweisen. Löscht alle Zeilen, deren Spaltenwerte den Primärschlüssel-Spaltenwerten der Zeile entsprechen und bei denen die übrigen Spalten in der Datenquelle den ursprünglichen Werten der Zeile entsprechen. Weitere Informationen finden Sie unter "Vollständiges Parallelitätsmodell für Updates und Löschvorgänge" weiter unten in diesem Thema.

Die Logik beim automatischen Generieren von Befehlen für UPDATE- und DELETE-Anweisungen basiert auf der vollständigen Parallelität, d. h., die Datensätze werden für die Bearbeitung nicht gesperrt und können von anderen Benutzern oder Prozessen jederzeit geändert werden. Da ein Datensatz nach der Rückgabe aus der SELECT-Anweisung und vor der Ausführung der UPDATE- oder DELETE-Anweisung ggf. geändert wurde, enthält die automatisch generierte UPDATE- oder DELETE-Anweisung eine WHERE-Klausel, die angibt, dass eine Zeile nur dann aktualisiert wird, wenn sie alle ursprünglichen Werte enthält und nicht aus der Datenquelle gelöscht wurde. Hierdurch wird vermieden, dass neue Daten überschrieben werden. In Fällen, in denen ein automatisch generierter Updatebefehl versucht, eine Zeile zu aktualisieren, die gelöscht wurde oder nicht die ursprünglichen Werte im DataSet enthält, hat der Befehl keine Auswirkungen auf Datensätze, und es wird eine DBConcurrencyException ausgelöst.

Wenn UPDATE oder DELETE unabhängig von den ursprünglichen Werten ausgeführt werden sollen, muss der UpdateCommand für den DataAdapter explizit festgelegt und die automatische Befehlsgenerierung damit außer Kraft gesetzt werden.

Folgende Einschränkungen gelten für die automatische Generierung von Befehlen.

Die Logik für die automatische Generierung von Befehlen generiert INSERT-, UPDATE- oder DELETE-Befehle für eigenständige Tabellen, wobei Verknüpfungen mit anderen Tabellen in der Datenquelle unberücksichtigt bleiben. Daher kann ein Fehler auftreten, wenn Sie Update aufrufen, um Änderungen an einer Spalte zu übermitteln, die in der Datenbank Fremdschlüsseleinschränkungen unterworfen ist. Sie können diese Ausnahme vermeiden, indem Sie zum Aktualisieren von Spalten, die einer Einschränkung eines Fremdschlüssels unterworfen sind, nicht den DbCommandBuilder verwenden, sondern die Anweisungen zur Durchführung der Operation explizit angeben.

Die Logik für die automatische Befehlsgenerierung kann fehlschlagen, wenn Spalten- oder Tabellennamen Sonderzeichen wie Leerzeichen, Punkte, Anführungszeichen oder andere nicht alphanumerische Zeichen enthalten, selbst wenn diese durch Klammern getrennt sind. Leerzeichen können je nach Anbieter von der Generierungslogik durch Festlegen des QuotePrefix-Parameters und QuoteSuffix-Parameters möglicherweise verarbeitet werden, Sonderzeichen können jedoch nicht mit Escapezeichen versehen werden. Vollqualifizierte Tabellennamen der Form catalog.schema.table werden unterstützt.

Legen Sie zum automatischen Generieren von SQL-Anweisungen für einen DataAdapter zuerst die SelectCommand-Eigenschaft des DataAdapter fest. Erstellen Sie dann ein CommandBuilder-Objekt, und geben Sie als Argument den DataAdapter an, für den der CommandBuilder automatisch SQL-Anweisungen generieren soll.

// Assumes that connection is a valid SqlConnection object
// inside of a using block.
SqlDataAdapter adapter = new SqlDataAdapter(
  "SELECT * FROM dbo.Customers", connection);
SqlCommandBuilder builder = new SqlCommandBuilder(adapter);
builder.QuotePrefix = "[";
builder.QuoteSuffix = "]";

Wenn Sie den CommandText von SelectCommand ändern, nachdem die Befehle INSERT, UPDATE oder DELETE automatisch generiert wurden, kann eine Ausnahme auftreten. Wenn der geänderte SelectCommand.CommandText Schemainformationen enthält, die nicht mit dem SelectCommand.CommandText zum Zeitpunkt der automatischen Generierung der Befehle INSERT, UPDATE oder DELETE konsistent sind, wird bei späteren Aufrufen der DataAdapter.Update-Methode möglicherweise versucht, auf Spalten zuzugreifen, die nicht mehr in der aktuellen Tabelle vorhanden sind, auf die SelectCommand verweist. In diesem Fall wird eine Ausnahme ausgelöst.

Sie können die vom CommandBuilder zum automatischen Generieren von Befehlen verwendeten Schemainformationen aktualisieren, indem Sie die RefreshSchema-Methode des CommandBuilder aufrufen.

Wenn Sie wissen möchten, welcher Befehl automatisch generiert wurde, können Sie mit den Methoden GetInsertCommand, GetUpdateCommand und GetDeleteCommand des CommandBuilder-Objekts Verweise auf die Befehle abrufen und die CommandText-Eigenschaft des zugeordneten Befehls überprüfen.

Im folgenden Codebeispiel wird der automatisch generierte UPDATE-Befehl in die Konsole geschrieben.

Console.WriteLine(builder.GetUpdateCommand().CommandText)

Das folgende Beispiel erstellt die Customers-Tabelle im custDS-Dataset neu. Die RefreshSchema-Methode wird zum Aktualisieren der automatisch generierten Befehle mit den neuen Spalteninformationen aufgerufen.

// Assumes an open SqlConnection and SqlDataAdapter inside of a using block.
adapter.SelectCommand.CommandText = 
  "SELECT CustomerID, ContactName FROM dbo.Customers";
builder.RefreshSchema();

custDS.Tables.Remove(custDS.Tables["Customers"]);
adapter.Fill(custDS, "Customers");
Anzeigen: