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 aus, indem die Methode aufgerufen wird, die von der UpdateMethod Eigenschaft identifiziert wird und alle Parameter verwendet werden, die in den keys, valuesoder oldValues Auflistungen angegeben werden.
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 Primärschlüssel, der mit der UpdateMethod Eigenschaft zum Ausführen des Aktualisierungsdatenbankvorgangs verwendet werden soll. Wenn der Methode keine Schlüssel zugeordnet sind, übergeben Sie .null
- values
- IDictionary
Eine IDictionary von Werten, die mit dem UpdateMethod Aktualisierungsdatenbankvorgang verwendet werden sollen. Wenn der Methode keine Parameter zugeordnet sind, übergeben Sie .null
- oldValues
- IDictionary
Ein IDictionary Wert, der die ursprünglichen Werte im zugrunde liegenden Datenspeicher darstellt. Wenn der Abfrage keine Parameter zugeordnet sind, übergeben Sie .null
Gibt zurück
Die Anzahl der aktualisierten Zeilen; oder -1, wenn die Zahl nicht bekannt ist. Weitere Informationen finden Sie unter Update().
Ausnahmen
Die CanInsert Eigenschaft gibt zurück false.
oldValues ist null oder leer und ConflictDetection ist auf CompareAllValues.
Hinweise
Die ObjectDataSourceView Klasse implementiert die geerbte ExecuteUpdate Methode, um Daten mithilfe eines Geschäftsobjekts zu aktualisieren. Seitenentwickler und datengebundene Steuerelementautoren rufen die ExecuteUpdate Methode nicht direkt auf. Verwenden Sie stattdessen die öffentlich verfügbar gemachte Update Methode.
Die Werte, die in den keys Auflistungen values enthalten sind, 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 Werte, die in der oldValues Auflistung enthalten sind, mit der OldValuesParameterFormatString Eigenschaft formatiert und ebenfalls zusammengeführt.
Bevor der Aktualisierungsvorgang ausgeführt wird, wird die OnUpdating Methode aufgerufen, um das Updating Ereignis auszuheben. Sie können dieses Ereignis behandeln, um die Werte der Parameter zu untersuchen und vor einer Aktualisierung eine beliebige Vorverarbeitung durchzuführen. Zum Ausführen eines Aktualisierungsvorgangs verwendet die ObjectDataSourceView Spiegelung, um die Methode aufzurufen, die durch die UpdateMethod Eigenschaft und alle zugehörigen Parameter in der keys Auflistung identifiziert wird, und führt sie dann aus. Nach Abschluss des Vorgangs wird die OnUpdated Methode aufgerufen, um das Updated Ereignis auszuheben. Sie können dieses Ereignis behandeln, um alle Rückgabewerte, Fehlercodes zu untersuchen und jede Nachbearbeitung durchzuführen.
Weitere Informationen zum Zurückgeben der Anzahl der aktualisierten Zeilen finden Sie unter Update.
