Udostępnij za pośrednictwem


ObjectDataSourceView.ExecuteInsert(IDictionary) Metoda

Definicja

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

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.

Dotyczy

Zobacz też