SqlDataSourceView.ExecuteInsert(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ę wstawiania przy użyciu InsertCommand ciągu SQL, wszystkich parametrów określonych w InsertParameters kolekcji i wartości, które znajdują się w określonej values kolekcji.

protected:
 override int ExecuteInsert(System::Collections::IDictionary ^ values);

protected override int ExecuteInsert (System.Collections.IDictionary values);

override this.ExecuteInsert : System.Collections.IDictionary -> int

Protected Overrides Function ExecuteInsert (values As IDictionary) As Integer

Parametry

values: IDictionary

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

Zwraca

Int32

Wartość reprezentująca liczbę wierszy wstawionych do bazowej bazy danych.

Wyjątki

InvalidOperationException

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

HttpException

Bieżący użytkownik nie ma odpowiednich uprawnień, aby uzyskać dostęp do bazy danych.

NotSupportedException

Właściwość CanInsert to false.

Uwagi

Klasa SqlDataSourceView implementuje dziedziczona ExecuteInsert metodę wstawiania danych do bazy danych. Deweloperzy stron i autorzy kontrolek powiązanych z danymi nie nazywają ExecuteInsert metody bezpośrednio; zamiast tego należy użyć publicznie uwidocznionej Insert metody.

Przed wykonaniem operacji wstawiania metoda jest wywoływana w OnInserting celu podniesienia Inserting zdarzenia. To zdarzenie można obsłużyć w celu zbadania wartości parametrów i wykonania dowolnego przetwarzania wstępnego przed wstawieniem.

Aby wykonać operację wstawiania, SqlDataSourceView obiekt tworzy obiekt przy użyciu InsertCommand tekstu i skojarzonych InsertParameters właściwości, a następnie wykonuje DbCommand obiekt względem bazowej bazy danych.DbCommand Po zakończeniu wstawiania metoda jest wywoływana, OnInserted aby zgłosić Inserted zdarzenie. To zdarzenie można obsłużyć, aby zbadać wszystkie zwracane wartości i kody błędów oraz wykonać dowolne przetwarzanie końcowe.

Dotyczy