SqlDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Methode

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Int32

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

Ausnahmen

InvalidOperationException

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.

HttpException

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

NotSupportedException

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 SqlDataSourceView DbCommand -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:

Share via