SqlDataSourceView.ExecuteInsert(IDictionary) Metoda
Definicja
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 -> intProtected Overrides Function ExecuteInsert (values As IDictionary) As IntegerParametry
- 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
Wartość reprezentująca liczbę wierszy wstawionych do bazowej bazy danych.
Wyjątki
Nie SqlDataSource można nawiązać połączenia z bazowym źródłem danych.
Bieżący użytkownik nie ma odpowiednich uprawnień, aby uzyskać dostęp do bazy danych.
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.
