ObjectDataSource.Insert Metoda

Definice

Provede operaci vložení voláním metody, která je identifikovaná InsertMethod vlastností a všemi parametry v InsertParameters kolekci.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

Návraty

Int32

Hodnota, která představuje počet řádků vložených do základního úložiště dat.A value that represents the number of rows inserted into the underlying data storage.

Poznámky

Před Insert provedením operace OnInserting je volána metoda pro vyvolání Inserting události.Before the Insert operation is performed, the OnInserting method is called to raise the Inserting event. Událost můžete zpracovat Inserting pro kontrolu hodnot parametrů a k provedení jakéhokoli předběžného zpracování před Insert operací.You can handle the Inserting event to examine the values of the parameters and to perform any preprocessing before an Insert operation. Chcete-li provést operaci vložení, ObjectDataSourceView objekt používá reflexi k vytvoření instance objektu, který je identifikován TypeName vlastností.To perform an insert operation, the ObjectDataSourceView object uses reflection to create an instance of the object that is identified by the TypeName property. Pak zavolá metodu identifikovanou InsertMethod vlastností pomocí všech přidružených InsertParameters vlastností.It then calls the method that is identified by the InsertMethod property, using any associated InsertParameters properties. Po Insert dokončení operace OnInserted je metoda volána k vyvolání Inserted události.After the Insert operation completes, the OnInserted method is called to raise the Inserted event. Událost můžete zpracovat Inserted k prohlédnutí libovolných vrácených hodnot, výstupních parametrů a výjimek a k provedení následného zpracování.You can handle the Inserted event to examine any return values, output parameters, and exceptions, and to perform any post-processing.

InsertMetoda se deleguje k Insert metodě ObjectDataSourceView , která je přidružena k ObjectDataSource ovládacímu prvku.The Insert method delegates to the Insert method of the ObjectDataSourceView that is associated with the ObjectDataSource control.

Další informace o slučování parametrů, životnosti objektů a rozlišení metod naleznete v tématu InsertMethod .For more information about parameter merging, object lifetime, and method resolution, see InsertMethod.

Ovládací prvky Data-BoundData-Bound Controls

Když ObjectDataSource je objekt přidružen k ovládacímu prvku vázaného na data, jako je například GridView ovládací prvek, není nutné volat Insert metodu z kódu stránky.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 je vyvolána přímo ovládacím prvkem vázaným na data namísto.The Insert method is invoked directly by the data-bound control instead.

Platí pro

Viz také