Udostępnij za pośrednictwem


SqlDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Metoda

Definicja

Wykonuje operację aktualizacji przy użyciu UpdateCommand ciągu SQL, wszystkich parametrów w UpdateParameters kolekcji oraz wartości, które znajdują się w określonych keyskolekcjach , valuesi 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ą UpdateCommand do wykonania operacji aktualizacji bazy danych. Jeśli nie ma żadnych kluczy skojarzonych z zapytaniem lub jeśli UpdateCommand właściwość nie jest sparametryzowanym zapytaniem SQL, przekaż polecenie null.

values
IDictionary

Wartość IDictionary do użycia z właściwością UpdateCommand w celu wykonania operacji aktualizacji bazy danych. Jeśli nie ma parametrów skojarzonych z zapytaniem lub jeśli UpdateCommand parametr nie jest sparametryzowanym zapytaniem SQL, przekaż polecenie null.

oldValues
IDictionary

Element IDictionary reprezentujący oryginalne wartości w bazie danych. Jeśli nie ma parametrów skojarzonych z zapytaniem lub jeśli UpdateCommand właściwość nie jest sparametryzowanym zapytaniem SQL, przekaż polecenie null.

Zwraca

Wartość reprezentująca liczbę wierszy zaktualizowanych w bazowej bazie danych.

Wyjątki

Nie SqlDataSource można nawiązać połączenia z bazowym źródłem danych.

-lub-

Właściwość jest ustawiona ConflictDetectionCompareAllValues na wartość i nie są przekazywane żadne oldValues parametry.

Bieżący użytkownik nie ma odpowiednich uprawnień do uzyskania dostępu do bazy danych.

Właściwość CanUpdate to false.

Uwagi

Klasa SqlDataSourceView implementuje dziedziczona ExecuteUpdate metodę w celu zaktualizowania danych w bazie danych. 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 kolekcjach i values są oceniane i scalane z dowolnymi wartościami zawartymi w kolekcji UpdateParameters . Jeśli właściwość jest ustawiona ConflictDetection na CompareAllValueswartość , wartości zawarte w oldValues kolekcji są formatowane za pomocą OldValuesParameterFormatString elementu , a także 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 sprawdzenia wartości parametrów i wykonania dowolnego przetwarzania wstępnego przed aktualizacją.

Aby wykonać operacjęDbCommand, SqlDataSourceView kompiluje obiekt przy użyciu UpdateCommand tekstu i wszelkich skojarzonych UpdateParameters właściwości, a następnie wykonuje DbCommand obiekt względem bazowej bazy danych. Po zakończeniu operacji wywoływana OnUpdated jest metoda w celu wywołania Updated zdarzenia. To zdarzenie można obsłużyć w celu zbadania wszystkich zwracanych wartości i kodów błędów oraz wykonania dowolnego przetwarzania końcowego.

Dotyczy

Zobacz też