SqlDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Methode

Definition

Führt mithilfe der UpdateCommand-SQL-Zeichenfolge, aller Parameter in der UpdateParameters-Auflistung sowie der Werte in den angegebenen Auflistungen keys, values und oldValues einen Aktualisierungsvorgang aus.

protected:
 override int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);
protected override int ExecuteUpdate (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);
override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
Protected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

Parameter

keys
IDictionary

Ein IDictionary mit Primärschlüsseln, die mit der UpdateCommand-Eigenschaft zum Ausführen des Aktualisierungsvorgangs für die Datenbank verwendet werden. Wenn der Abfrage keine Schlüssel zugeordnet sind oder die UpdateCommand-Eigenschaft keine parametrisierte SQL-Abfrage ist, wird null übergeben.

values
IDictionary

Ein IDictionary mit Werten, die mit der UpdateCommand-Eigenschaft zum Ausführen des Aktualisierungsvorgangs für die Datenbank verwendet werden. Wenn der Abfrage keine Parameter zugeordnet sind oder der UpdateCommand keine parametrisierte SQL-Abfrage ist, wird null übergeben.

oldValues
IDictionary

Ein IDictionary, das die ursprünglichen Werte in der Datenbank darstellt. Wenn der Abfrage keine Parameter zugeordnet sind oder die UpdateCommand-Eigenschaft keine parametrisierte SQL-Abfrage ist, wird null übergeben.

Gibt zurück

Ein Wert, der die Anzahl der aktualisierten Zeilen in der zugrunde liegenden Datenbank darstellt.

Ausnahmen

Die SqlDataSource kann keine Verbindung mit der zugrunde liegenden Datenquelle herstellen.

- oder -

Die ConflictDetection-Eigenschaft wird auf den CompareAllValues-Wert festgelegt, und es werden keine oldValues-Parameter übergeben.

Der aktuelle Benutzer verfügt nicht über die erforderlichen Berechtigungen für den Zugriff auf die Datenbank.

Die CanUpdate-Eigenschaft ist false.

Hinweise

Die SqlDataSourceView -Klasse implementiert die geerbte ExecuteUpdate Methode, um Daten in einer Datenbank zu aktualisieren. Seitenentwickler und Autoren von datengebundenen Steuerelementen rufen die ExecuteUpdate -Methode nicht direkt auf. Verwenden Sie stattdessen die öffentlich verfügbar gemachte Update Methode.

Die in den keys Auflistungen und values enthaltenen Werte werden ausgewertet und mit allen werten zusammengeführt, die in der UpdateParameters Auflistung enthalten sind. Wenn die ConflictDetection -Eigenschaft auf CompareAllValuesfestgelegt ist, werden die in der oldValues Auflistung enthaltenen Werte mit formatiert OldValuesParameterFormatString und ebenfalls zusammengeführt.

Bevor der Aktualisierungsvorgang ausgeführt wird, wird die OnUpdating -Methode aufgerufen, um das Ereignis auszulösen Updating . Sie können dieses Ereignis behandeln, um die Werte der Parameter zu untersuchen und vor einem Update vorzuverarbeiten.

Um den Vorgang auszuführen, erstellt ein SqlDataSourceViewDbCommand -Objekt unter Verwendung des UpdateCommand Texts und aller zugeordneten UpdateParameters Eigenschaften und führt dann das DbCommand -Objekt für die zugrunde liegende Datenbank aus. Nach Abschluss des Vorgangs wird die OnUpdated -Methode aufgerufen, um das -Ereignis auszulösen Updated . Sie können dieses Ereignis behandeln, um Rückgabewerte und Fehlercodes zu untersuchen und eine nachbereitende Verarbeitung durchzuführen.

Gilt für:

Weitere Informationen