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 von Name-Wert-Paaren, die bei einem Einfügevorgang verwendet wurden.
Gibt zurück
Die Anzahl von Elementen, die in den zugrunde liegenden Datenspeicher eingefügt wurden.
Ausnahmen
Der ExecuteInsert(IDictionary)-Vorgang wird von der DataSourceView-Klasse nicht unterstützt.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie eine Klasse, die die DataSourceView -Klasse erweitert, die CanInsert -Eigenschaft und die ExecuteInsert -Methode überschreiben 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 ein Satz von Name-Wert-Paaren, die Datenspalten oder Felder und die entsprechenden einzufügenden Werte darstellen.
Hinweis
Die DataSourceView Standardimplementierung der Klasse besteht darin, eine NotSupportedException Ausnahme auszulösen. Wenn Sie die DataSourceView -Klasse erweitern, überschreiben Sie die -Methode, wenn Ihre Klasse das ExecuteInsert Einfügen in den zugrunde liegenden Datenspeicher unterstützt.
