SqlDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

Int32

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

Wyjątki

InvalidOperationException

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

-lub-

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

HttpException

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

NotSupportedException

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