ObjectDataSource.Insert Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Führt einen Einfügevorgang aus, indem die Methode aufgerufen wird, die durch die InsertMethod Eigenschaft und alle Parameter in der InsertParameters Auflistung identifiziert wird.
public:
int Insert();
public int Insert();
member this.Insert : unit -> int
Public Function Insert () As Integer
Gibt zurück
Ein Wert, der die Anzahl der Zeilen darstellt, die in den zugrunde liegenden Datenspeicher eingefügt wurden.
Hinweise
Bevor der Insert Vorgang ausgeführt wird, wird die OnInserting Methode aufgerufen, um das Inserting Ereignis auszuheben. Sie können das Inserting Ereignis behandeln, um die Werte der Parameter zu untersuchen und alle Vorverarbeitungen vor einem Insert Vorgang auszuführen. Zum Ausführen eines Einfügevorgangs verwendet das ObjectDataSourceView Objekt Spiegelung, um eine Instanz des Objekts zu erstellen, das durch die TypeName Eigenschaft identifiziert wird. Anschließend wird die Methode aufgerufen, die von der InsertMethod Eigenschaft identifiziert wird, wobei alle zugeordneten Eigenschaften verwendet werden InsertParameters . Nach Abschluss des Insert Vorgangs wird die OnInserted Methode aufgerufen, um das Inserted Ereignis auszuheben. Sie können das Inserted Ereignis behandeln, um alle Rückgabewerte, Ausgabeparameter und Ausnahmen zu untersuchen und jede Nachbearbeitung durchzuführen.
Die Insert Methode delegiert an die Insert Methode des Steuerelements, das ObjectDataSourceView dem ObjectDataSource Steuerelement zugeordnet ist.
Weitere Informationen zum Zusammenführen von Parametern, zur Objektlebensdauer und zur Methodenauflösung finden Sie unter InsertMethod.
Data-Bound-Steuerelemente
Wenn das ObjectDataSource Objekt einem datengebundenen Steuerelement zugeordnet ist, z. B. dem GridView Steuerelement, ist es nicht erforderlich, die Insert Methode aus Seitencode aufzurufen. Die Insert Methode wird stattdessen direkt vom datengebundenen Steuerelement aufgerufen.