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 einen Einfügevorgang mithilfe der InsertCommand SQL-Zeichenfolge, aller Parameter aus, die in der InsertParameters Auflistung angegeben sind, und die Werte, die sich in der angegebenen values Auflistung befinden.
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 Wert, der mit der InsertCommand Eigenschaft zum Ausführen des Einfügedatenbankvorgangs verwendet wird. Wenn der Abfrage keine Parameter zugeordnet sind oder die InsertCommand Eigenschaft keine parametrisierte SQL-Abfrage ist, übergeben Sie null.
Gibt zurück
Ein Wert, der die Anzahl der Zeilen darstellt, die in die zugrunde liegende Datenbank eingefügt wurden.
Ausnahmen
Die SqlDataSource Verbindung mit der zugrunde liegenden Datenquelle kann nicht hergestellt werden.
Der aktuelle Benutzer verfügt nicht über die richtigen Berechtigungen, um Zugriff auf die Datenbank zu erhalten.
Die CanInsert Eigenschaft ist false.
Hinweise
Die SqlDataSourceView Klasse implementiert die geerbte ExecuteInsert Methode, um Daten in eine Datenbank einzufügen. Seitenentwickler und datengebundene Steuerelementautoren 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 Inserting Ereignis auszuheben. Sie können dieses Ereignis behandeln, um die Werte der Parameter zu untersuchen und vor dem Einfügen eine beliebige Vorverarbeitung durchzuführen.
Zum Ausführen eines Einfügevorgangs erstellt das SqlDataSourceView Objekt ein DbCommand Objekt mit dem InsertCommand Text und den zugehörigen InsertParameters Eigenschaften und führt dann das DbCommand Objekt für die zugrunde liegende Datenbank aus. Nach Abschluss des Einfügens wird die OnInserted Methode aufgerufen, um das Inserted Ereignis auszuheben. Sie können dieses Ereignis behandeln, um alle Rückgabewerte und Fehlercodes zu untersuchen und jede Nachbearbeitung durchzuführen.