SqlDataSourceView.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 InsertCommand-SQL-Zeichenfolge, aller in der InsertParameters-Auflistung angegebenen Parameter sowie der Werte in der angegebenen values-Auflistung einen Einfügevorgang aus.
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 mit Werten, die zusammen mit der InsertCommand-Eigenschaft zum Ausführen eines Einfügevorgangs für die Datenbank verwendet werden. Wenn der Abfrage keine Parameter zugeordnet sind oder die InsertCommand-Eigenschaft keine parametrisierte SQL-Abfrage ist, wird null übergeben.
Gibt zurück
Ein Wert, der die Anzahl der in die zugrunde liegenden Datenbank eingefügten Zeilen darstellt.
Ausnahmen
Die SqlDataSource kann keine Verbindung mit der zugrunde liegenden Datenquelle herstellen.
Der aktuelle Benutzer verfügt nicht über die erforderlichen Berechtigungen für den Zugriff auf die Datenbank.
Die CanInsert-Eigenschaft ist false.
Hinweise
Die SqlDataSourceView -Klasse implementiert die geerbte ExecuteInsert Methode, um Daten in eine Datenbank einzufügen. Seitenentwickler und Autoren von datengebundenen Steuerelementen rufen die ExecuteInsert -Methode nicht direkt auf. Verwenden Sie stattdessen die öffentlich verfügbar gemachte 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 einer Einfügung vorzuverarbeiten.
Um einen Einfügevorgang auszuführen, erstellt das SqlDataSourceView -Objekt ein DbCommand -Objekt unter Verwendung des InsertCommand Texts und aller zugeordneten InsertParameters Eigenschaften und führt dann das DbCommand -Objekt für die zugrunde liegende Datenbank aus. Nach Abschluss der Einfügung wird die OnInserted -Methode aufgerufen, um das Ereignis auszulösen Inserted . Sie können dieses Ereignis behandeln, um Rückgabewerte und Fehlercodes zu untersuchen und eine nachbereitende Verarbeitung durchzuführen.
