Freigeben über


SqlDataSourceView.ExecuteInsert(IDictionary) Methode

Definition

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

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.

Gilt für:

Weitere Informationen