Freigeben über


ObjectDataSourceView.ExecuteInsert(IDictionary) Methode

Definition

Führt mithilfe der angegebenen values-Auflistung einen Einfügevorgang durch Aufrufen der Geschäftsobjektmethode aus, die von der InsertMethod-Eigenschaft angegeben wird.

protected:
 override int ExecuteInsert(System::Collections::IDictionary ^ values);
protected override int ExecuteInsert (System.Collections.IDictionary values);
override this.ExecuteInsert : System.Collections.IDictionary -> int
Protected Overrides Function ExecuteInsert (values As IDictionary) As Integer

Parameter

values
IDictionary

Ein IDictionary von Parametern, die mit der InsertMethod-Eigenschaft zum Ausführen des Einfügevorgangs verwendet werden. Wenn der Methode keine Parameter zugeordnet sind, muss null übergeben werden.

Gibt zurück

Die Anzahl der eingefügten Zeilen, andernfalls -1 (wenn die Anzahl unbekannt ist). Weitere Informationen finden Sie unter Insert.

Ausnahmen

Die CanInsert-Eigenschaft gibt false zurück.

values hat den Wert null oder ist leer.

Hinweise

Die ObjectDataSourceView -Klasse implementiert die geerbte ExecuteInsert Methode zum Einfügen von Daten in einen zugrunde liegenden Datenspeicher mithilfe eines Geschäftsobjekts. Seitenentwickler und Datengebundene Steuerelementautoren rufen die ExecuteInsert Methode nicht direkt auf, sondern verwenden Sie stattdessen die öffentlich zugängliche Insert Methode.

Bevor der Einfügevorgang ausgeführt wird, wird die OnInserting -Methode aufgerufen, um das Ereignis auszulösen Inserting . Sie können dieses Ereignis behandeln, um die Werte der Parameter zu untersuchen und vor dem Aufruf der Insert Methode eine Vorverarbeitung durchzuführen.

Zum Ausführen eines Einfügevorgangs ruft das Steuerelement mithilfe von ObjectDataSourceView Reflektion die Methode auf, die von der InsertMethod -Eigenschaft und allen zugeordneten Parametern in der values Auflistung identifiziert wird, und führt sie dann aus. Nach Abschluss des Vorgangs wird die OnInserted -Methode aufgerufen, um das Ereignis auszulösen Inserted . Sie können dieses Ereignis behandeln, um alle Rückgabewerte, Fehlercodes und nach der Nachverarbeitung zu untersuchen.

Weitere Informationen zum Zurückgeben der Anzahl der eingefügten Zeilen finden Sie unter Insert.

Gilt für:

Weitere Informationen