Freigeben über


DataSourceView.ExecuteInsert(IDictionary) Methode

Definition

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 -> int
Protected Overridable Function ExecuteInsert (values As IDictionary) As Integer

Parameter

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.

Gilt für:

Weitere Informationen