DataSourceView.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 in der Liste der Daten aus, die das DataSourceView Objekt darstellt.
protected:
virtual int ExecuteInsert(System::Collections::IDictionary ^ values);protected virtual int ExecuteInsert(System.Collections.IDictionary values);abstract member ExecuteInsert : System.Collections.IDictionary -> int
override this.ExecuteInsert : System.Collections.IDictionary -> intProtected Overridable Function ExecuteInsert (values As IDictionary) As IntegerParameter
- values
- IDictionary
Ein IDictionary Name/Wert-Paar, das während eines Einfügevorgangs verwendet wird.
Gibt zurück
Die Anzahl der Elemente, die in den zugrunde liegenden Datenspeicher eingefügt wurden.
Ausnahmen
Der ExecuteInsert(IDictionary) Vorgang wird von der DataSourceView.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie eine Klasse, die die Klasse erweitert, die DataSourceViewCanInsert Eigenschaft und die ExecuteInsert Methode außer Kraft setzen kann. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die DataSourceView Klasse bereitgestellt wird.
// The CsvDataSourceView does not currently
// permit insertion of a new record. You can
// modify or extend this sample to do so.
public override bool CanInsert {
get {
return false;
}
}
protected override int ExecuteInsert(IDictionary values)
{
throw new NotSupportedException();
}
' The CsvDataSourceView does not currently
' permit insertion of a new record. You can
' modify or extend this sample to do so.
Public Overrides ReadOnly Property CanInsert() As Boolean
Get
Return False
End Get
End Property
Protected Overrides Function ExecuteInsert(values As IDictionary) As Integer
Throw New NotSupportedException()
End Function 'ExecuteInsert
Hinweise
Datengebundene Steuerelemente können bestimmen, ob der ExecuteInsert Vorgang von einem Datenquellensteuerelement unterstützt wird, indem das DataSourceView Objekt mithilfe der GetView Methode abgerufen und die CanInsert Eigenschaft überprüft wird.
Der values Parameter ist eine Gruppe von Name/Wert-Paaren, die Datenspalten oder Felder und entsprechende Werte darstellen, die eingefügt werden sollen.
Hinweis
Die DataSourceView Standardimplementierung der Klasse besteht darin, eine NotSupportedException Ausnahme auszuwerfen. Wenn Sie die DataSourceView Klasse erweitern, überschreiben Sie die ExecuteInsert Methode, wenn ihre Klasse das Einfügen in den zugrunde liegenden Datenspeicher unterstützt.
