ObjectDataSourceView.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, wywołując metodę obiektu biznesowego InsertMethod , która jest identyfikowana przez właściwość przy użyciu 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

Parametrów IDictionary używanych z właściwością InsertMethod do wykonania operacji wstawiania. Jeśli nie ma parametrów skojarzonych z metodą , przekaż wartość null.

Zwraca

Int32

Liczba wstawionych wierszy; w przeciwnym razie wartość -1, jeśli liczba nie jest znana. Aby uzyskać więcej informacji, zobacz Insert.

Wyjątki

NotSupportedException

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

InvalidOperationException

values jest lub jest null pusta.

Uwagi

Klasa ObjectDataSourceView implementuje dziedziczona ExecuteInsert metodę wstawiania danych do bazowego magazynu danych przy użyciu obiektu biznesowego. 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 wstawiania wywoływana OnInserting jest metoda w celu wywołania Inserting zdarzenia. To zdarzenie można obsłużyć w celu zbadania wartości parametrów i wykonania dowolnego przetwarzania wstępnego przed Insert wywołaniem metody.

Aby wykonać operację wstawiania, kontrolka ObjectDataSourceView używa odbicia w celu wywołania metody identyfikowanej przez InsertMethod właściwość i wszelkich skojarzonych parametrów, które znajdują się w values kolekcji, a następnie wykonuje ją. Po zakończeniu operacji wywoływana OnInserted jest metoda w celu wywołania Inserted 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 wstawionych wierszy, zobacz Insert.

Dotyczy

Udostępnij przez