ObjectDataSource.Insert 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ę, która jest identyfikowana przez InsertMethod właściwość i wszystkie parametry w kolekcji InsertParameters .
public:
int Insert();
public int Insert ();
member this.Insert : unit -> int
Public Function Insert () As Integer
Zwraca
Wartość reprezentująca liczbę wierszy wstawionych do bazowego magazynu danych.
Uwagi
Przed wykonaniem Insert operacji wywoływana OnInserting jest metoda w celu wywołania Inserting zdarzenia. Zdarzenie można obsłużyć Inserting w celu zbadania wartości parametrów i wykonania dowolnego przetwarzania wstępnego przed operacją Insert . Aby wykonać operację wstawiania, ObjectDataSourceView obiekt używa odbicia w celu utworzenia wystąpienia obiektu identyfikowanego przez TypeName właściwość. Następnie wywołuje metodę InsertMethod , która jest identyfikowana przez właściwość, przy użyciu dowolnych skojarzonych InsertParameters właściwości. Po zakończeniu Insert operacji metoda jest wywoływana OnInserted , aby zgłosić Inserted zdarzenie. Zdarzenie można obsłużyć Inserted w celu zbadania wszystkich wartości zwracanych, parametrów wyjściowych i wyjątków oraz wykonania dowolnego przetwarzania końcowego.
Metoda Insert deleguje do Insert metody skojarzonej ObjectDataSourceView z kontrolką ObjectDataSource .
Aby uzyskać więcej informacji na temat scalania parametrów, okresu istnienia obiektu i rozpoznawania metod, zobacz InsertMethod.
kontrolki Data-Bound
ObjectDataSource Gdy obiekt jest skojarzony z formantem powiązanym z danymi, takim jak kontrolkaGridView, nie jest konieczne wywołanie Insert metody z kodu strony. Metoda Insert jest wywoływana bezpośrednio przez kontrolkę powiązana z danymi.