ObjectDataSourceView.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, 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 -> intProtected Overrides Function ExecuteInsert (values As IDictionary) As IntegerParametry
- 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
Liczba wstawionych wierszy; w przeciwnym razie wartość -1, jeśli liczba nie jest znana. Aby uzyskać więcej informacji, zobacz Insert.
Wyjątki
Właściwość CanInsert zwraca wartość false.
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.
