ObjectDataSource.Insert Methode

Definition

Führt einen Einfügevorgang durch Aufrufen der von der InsertMethod-Eigenschaft angegebenen Methode mit sämtlichen Parametern in der InsertParameters-Auflistung aus.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

Gibt zurück

Int32

Ein Wert, der die Anzahl der im zugrunde liegenden Datenspeicher eingefügten Zeilen darstellt.A value that represents the number of rows inserted into the underlying data storage.

Hinweise

Bevor der- Insert Vorgang ausgeführt wird, OnInserting wird die-Methode aufgerufen, um das-Ereignis zu erhöhen Inserting .Before the Insert operation is performed, the OnInserting method is called to raise the Inserting event. Sie können das Inserting -Ereignis behandeln, um die Werte der Parameter zu überprüfen und vor einem Vorgang eine Vorverarbeitung auszuführen Insert .You can handle the Inserting event to examine the values of the parameters and to perform any preprocessing before an Insert operation. Zum Ausführen eines Einfügevorgangs ObjectDataSourceView verwendet das-Objekt Reflektion, um eine Instanz des-Objekts zu erstellen, das durch die-Eigenschaft identifiziert wird TypeName .To perform an insert operation, the ObjectDataSourceView object uses reflection to create an instance of the object that is identified by the TypeName property. Anschließend wird die-Methode aufgerufen, die durch die-Eigenschaft identifiziert wird InsertMethod , wobei alle zugehörigen Eigenschaften verwendet werden InsertParameters .It then calls the method that is identified by the InsertMethod property, using any associated InsertParameters properties. Nachdem der Insert Vorgang abgeschlossen wurde, OnInserted wird die-Methode aufgerufen, um das-Ereignis zu erhöhen Inserted .After the Insert operation completes, the OnInserted method is called to raise the Inserted event. Sie können das Inserted -Ereignis behandeln, um alle Rückgabewerte, Ausgabeparameter und Ausnahmen zu überprüfen und Nachbearbeitung auszuführen.You can handle the Inserted event to examine any return values, output parameters, and exceptions, and to perform any post-processing.

Die- Insert Methode delegiert an die- Insert Methode des ObjectDataSourceView , das dem-Steuerelement zugeordnet ist ObjectDataSource .The Insert method delegates to the Insert method of the ObjectDataSourceView that is associated with the ObjectDataSource control.

Weitere Informationen zum Zusammenführen von Parametern, zur Objekt Lebensdauer und zur Methoden Auflösung finden Sie unter InsertMethod .For more information about parameter merging, object lifetime, and method resolution, see InsertMethod.

Datengebundene SteuerelementeData-Bound Controls

Wenn das ObjectDataSource -Objekt einem Daten gebundenen Steuerelement zugeordnet ist, z. b GridView . dem-Steuerelement, ist es nicht erforderlich, die- Insert Methode aus dem Seitencode aufzurufen.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. InsertStattdessen wird die-Methode direkt durch das Daten gebundene Steuerelement aufgerufen.The Insert method is invoked directly by the data-bound control instead.

Gilt für:

Siehe auch