Freigeben über


ObjectDataSourceView.ExecuteUpdate Methode

Definition

Führt einen Aktualisierungsvorgang durch den Aufruf der von der UpdateMethod-Eigenschaft angegebenen Methode und unter Verwendung aller in den Auflistungen keys, values und oldValues vorhandenen Parameter durch.

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, das mit der UpdateMethod-Eigenschaft zum Ausführen des Aktualisierungsvorgangs für die Datenbank verwendet wird. Wenn der Methode keine Schlüssel zugeordnet sind, muss null übergeben werden.

values
IDictionary

Ein IDictionary mit Werten, das mit UpdateMethod zum Ausführen des Aktualisierungsvorgangs für die Datenbank verwendet wird. Wenn der Methode keine Parameter zugeordnet sind, muss null übergeben werden.

oldValues
IDictionary

Ein IDictionary, das die ursprünglichen Werte im zugrunde liegenden Datenspeicher darstellt. Wenn der Abfrage keine Parameter zugeordnet sind, muss null übergeben werden.

Gibt zurück

Die Anzahl der aktualisierten Zeilen oder -1, wenn die Anzahl unbekannt ist. Weitere Informationen finden Sie unter Update().

Ausnahmen

Die CanInsert-Eigenschaft gibt false zurück.

oldValues ist null oder leer, und ConflictDetection ist auf CompareAllValues festgelegt.

Hinweise

Die ObjectDataSourceView -Klasse implementiert die geerbte ExecuteUpdate Methode, um Daten mithilfe eines Geschäftsobjekts 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 den CompareAllValues -Wert festgelegt ist, werden die in der oldValues Auflistung enthaltenen Werte mit der OldValuesParameterFormatString -Eigenschaft formatiert und auch 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 einen Aktualisierungsvorgang auszuführen, verwendet reflektion ObjectDataSourceView , um die Methode aufzurufen, die durch die UpdateMethod -Eigenschaft und alle zugeordneten Parameter in der keys Auflistung identifiziert wird, und führt sie dann aus. Nach Abschluss des Vorgangs wird die OnUpdated -Methode aufgerufen, um das -Ereignis auszulösen Updated . Sie können dieses Ereignis behandeln, um alle Rückgabewerte und Fehlercodes zu untersuchen und eine Nachbearbeitung durchzuführen.

Weitere Informationen zum Zurückgeben der Anzahl aktualisierter Zeilen finden Sie unter Update.

Gilt für:

Weitere Informationen