ObjectDataSourceView.Update(IDictionary, IDictionary, IDictionary) 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.

public:
 int Update(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);
public int Update (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);
override this.Update : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
Public Function Update (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

Parameter

keys
IDictionary

Ein IDictionary der Schlüsselwerte, mit deren Hilfe das zu aktualisierende Element angegeben wird. Um diesen Aktualisierungsvorgang ausführen zu können, werden diese Parameter mit der von der UpdateMethod-Eigenschaft angegebenen Methode verwendet. Wenn der Methode keine Parameter zugeordnet sind, muss null übergeben werden.

values
IDictionary

Ein IDictionary mit neuen Werten, die auf die Datenquelle angewendet werden sollen. Um diesen Aktualisierungsvorgang für die Datenbank ausführen zu können, werden diese Parameter mit der von der UpdateMethod-Eigenschaft angegebenen Methode verwendet. Wenn der Methode keine Parameter zugeordnet sind, muss null übergeben werden.

oldValues
IDictionary

Ein IDictionary, das die zusätzlichen Nicht-Schlüsselwerte enthält, mit denen ein Abgleich mit dem Element in der Datenquelle ausgeführt wird. Zeilenwerte werden nur dann an die Löschmethode übergeben, wenn die ConflictDetection-Eigenschaft auf das CompareAllValues-Feld festgelegt ist.

Gibt zurück

Die Anzahl der aktualisierten Zeilen, andernfalls -1 (wenn die Anzahl unbekannt ist).

Hinweise

Der Standardwert ist -1. Dies bedeutet, dass eine unbekannte Anzahl von Zeilen aktualisiert wurde. Um einen anderen Wert zurückzugeben, legen Sie die AffectedRows -Eigenschaft des ObjectDataSourceStatusEventArgs -Objekts des Updated Ereignisses fest. Die Anzahl der betroffenen Zeilen wird in der Regel von der Update -Methode für das Geschäftsobjekt zurückgegeben, und dieser Wert ist über die ReturnValue -Eigenschaft des ObjectDataSourceStatusEventArgs -Parameters des Ereignisses Updated verfügbar.

Die Update -Methode ruft die ExecuteUpdate -Methode auf und übergibt die keysParameter , valuesund oldValues .

Gilt für:

Weitere Informationen