ObjectDataSourceView.ExecuteUpdate Methode
Definition
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 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 -> intProtected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As IntegerParameter
- 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.
