ObjectDataSourceView.ExecuteInsert(IDictionary) 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 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 -> intProtected Overrides Function ExecuteInsert (values As IDictionary) As IntegerParameter
- 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.
