Udostępnij za pośrednictwem


ObjectDataSourceView.ExecuteUpdate Metoda

Definicja

Wykonuje operację aktualizacji, wywołując metodę, która jest identyfikowana przez UpdateMethod właściwość i używając dowolnych parametrów dostarczonych w keyskolekcjach , valueslub oldValues .

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

Parametry

keys
IDictionary

Klucz IDictionary podstawowy używany z właściwością UpdateMethod do wykonania operacji aktualizacji bazy danych. Jeśli nie ma żadnych kluczy skojarzonych z metodą , przekaż null.

values
IDictionary

Wartość IDictionary , która ma być używana z wartością UpdateMethod do wykonania operacji aktualizacji bazy danych. Jeśli nie ma parametrów skojarzonych z metodą , przekaż wartość null.

oldValues
IDictionary

Obiekt IDictionary reprezentujący oryginalne wartości w bazowym magazynie danych. Jeśli nie ma żadnych parametrów skojarzonych z zapytaniem, przekaż polecenie null.

Zwraca

Liczba zaktualizowanych wierszy; lub -1, jeśli liczba nie jest znana. Aby uzyskać więcej informacji, zobacz Update().

Wyjątki

Właściwość CanInsert zwraca wartość false.

oldValues wartość jest null pusta ConflictDetection lub jest ustawiona na CompareAllValueswartość .

Uwagi

Klasa ObjectDataSourceView implementuje dziedziczona ExecuteUpdate metodę w celu zaktualizowania danych przy użyciu obiektu biznesowego. Deweloperzy stron i autorzy kontrolek powiązanych z danymi nie nazywają ExecuteUpdate metody bezpośrednio. Zamiast tego należy użyć publicznie uwidocznionej Update metody.

Wartości zawarte w keys kolekcji i values są oceniane i scalane z dowolnymi wartościami zawartymi w kolekcji UpdateParameters . ConflictDetection Jeśli właściwość jest ustawiona CompareAllValues na wartość, wartości zawarte w oldValues kolekcji są formatowane za OldValuesParameterFormatString pomocą właściwości i są również scalane.

Przed wykonaniem operacji aktualizacji wywoływana OnUpdating jest metoda w celu wywołania Updating zdarzenia. To zdarzenie można obsłużyć w celu zbadania wartości parametrów i wykonania dowolnego przetwarzania wstępnego przed aktualizacją. Aby wykonać operację aktualizacji, ObjectDataSourceView metoda używa odbicia w celu wywołania metody identyfikowanej przez UpdateMethod właściwość i wszelkich skojarzonych parametrów w keys kolekcji, a następnie wykonuje ją. Po zakończeniu operacji wywoływana OnUpdated jest metoda w celu wywołania Updated zdarzenia. To zdarzenie można obsłużyć w celu sprawdzenia wszystkich wartości zwracanych, kodów błędów i wykonania dowolnego przetwarzania końcowego.

Aby uzyskać więcej informacji na temat zwracania liczby zaktualizowanych wierszy, zobacz Update.

Dotyczy

Zobacz też