SqlDataSourceView.ExecuteInsert(IDictionary) Methode

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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 -> int

Protected Overrides Function ExecuteInsert (values As IDictionary) As Integer

Parameter

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

Int32

Ein Wert, der die Anzahl der in die zugrunde liegenden Datenbank eingefügten Zeilen darstellt.

Ausnahmen

InvalidOperationException

Die SqlDataSource kann keine Verbindung mit der zugrunde liegenden Datenquelle herstellen.

HttpException

Der aktuelle Benutzer verfügt nicht über die erforderlichen Berechtigungen für den Zugriff auf die Datenbank.

NotSupportedException

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.

Gilt für: