ObjectDataSource.Insert Metoda

Definicja

Wykonuje operację wstawiania, wywołując metodę, która jest identyfikowana przez InsertMethod Właściwość i wszystkie parametry w InsertParameters kolekcji.Performs an insert operation by calling the method that is identified by the InsertMethod property and any parameters in the InsertParameters collection.

public:
 int Insert();
public int Insert ();
member this.Insert : unit -> int
Public Function Insert () As Integer

Zwraca

Int32

Wartość, która reprezentuje liczbę wierszy wstawionych do magazynu danych źródłowych.A value that represents the number of rows inserted into the underlying data storage.

Uwagi

Przed Insert wykonaniem operacji OnInserting Metoda jest wywoływana w celu podniesienia Inserting zdarzenia.Before the Insert operation is performed, the OnInserting method is called to raise the Inserting event. Można obsłużyć Inserting zdarzenie, aby przeanalizować wartości parametrów i wykonać przetwarzanie wstępne przed Insert operacją.You can handle the Inserting event to examine the values of the parameters and to perform any preprocessing before an Insert operation. Aby wykonać operację wstawiania, ObjectDataSourceView obiekt używa odbicia w celu utworzenia wystąpienia obiektu, który jest identyfikowany przez TypeName Właściwość.To perform an insert operation, the ObjectDataSourceView object uses reflection to create an instance of the object that is identified by the TypeName property. Następnie wywołuje metodę, która jest identyfikowana przez InsertMethod Właściwość, przy użyciu wszelkich skojarzonych InsertParameters właściwości.It then calls the method that is identified by the InsertMethod property, using any associated InsertParameters properties. Po Insert zakończeniu operacji OnInserted Metoda jest wywoływana w celu podniesienia Inserted zdarzenia.After the Insert operation completes, the OnInserted method is called to raise the Inserted event. Możesz obsłużyć Inserted zdarzenie, aby przeanalizować wszelkie zwracane wartości, parametry wyjściowe i wyjątki oraz wykonać dowolne przetwarzanie końcowe.You can handle the Inserted event to examine any return values, output parameters, and exceptions, and to perform any post-processing.

InsertMetoda deleguje Insert metodę ObjectDataSourceView , która jest skojarzona z ObjectDataSource kontrolką.The Insert method delegates to the Insert method of the ObjectDataSourceView that is associated with the ObjectDataSource control.

Aby uzyskać więcej informacji na temat scalania parametrów, okresu istnienia obiektu i rozwiązania metody, zobacz InsertMethod .For more information about parameter merging, object lifetime, and method resolution, see InsertMethod.

Formanty powiązane z danymiData-Bound Controls

Gdy ObjectDataSource obiekt jest skojarzony z kontrolką powiązaną z danymi, taką jak GridView kontrolka, nie trzeba wywoływać Insert metody z kodu strony.When the ObjectDataSource object is associated with a data-bound control, such as the GridView control, it is not necessary to call the Insert method from page code. InsertMetoda jest wywoływana bezpośrednio przez formant powiązany z danymi.The Insert method is invoked directly by the data-bound control instead.

Dotyczy

Zobacz też