DataSourceView.ExecuteInsert(IDictionary) DataSourceView.ExecuteInsert(IDictionary) DataSourceView.ExecuteInsert(IDictionary) DataSourceView.ExecuteInsert(IDictionary) Method

Definition

Führt einen Einfügevorgang in der Liste der Daten aus, die das DataSourceView-Objekt darstellt.Performs an insert operation on the list of data that the DataSourceView object represents.

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 IDictionary IDictionary IDictionary

Ein IDictionary von Name-Wert-Paaren, die bei einem Einfügevorgang verwendet wurden.An IDictionary of name/value pairs used during an insert operation.

Gibt zurück

Die Anzahl von Elementen, die in den zugrunde liegenden Datenspeicher eingefügt wurden.The number of items that were inserted into the underlying data storage.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Klasse, DataSourceView die die-Klasse CanInsert erweitert, die ExecuteInsert -Eigenschaft und die-Methode überschreiben kann.The following code example demonstrates how a class that extends the DataSourceView class can override the CanInsert property and the ExecuteInsert method. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die DataSourceView -Klasse bereitgestellt wird.This code example is part of a larger example provided for the DataSourceView class.

// 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

Daten gebundene Steuerelemente können bestimmen, ob ExecuteInsert der Vorgang von einem Datenquellen-Steuerelement unterstützt wird DataSourceView , indem das GetView -Objekt mithilfe der- CanInsert Methode abgerufen und die-Eigenschaft überprüft wird.Data-bound controls can determine whether the ExecuteInsert operation is supported by a data source control by retrieving the DataSourceView object using the GetView method, and checking the CanInsert property.

Der values -Parameter ist ein Satz von Name-Wert-Paaren, die Datenspalten oder Felder und entsprechende einzufügende Werte darstellen.The values parameter is a set of name/value pairs that represents data columns or fields and corresponding values to insert.

Hinweis

Die DataSourceView Standard Implementierung der-Klasse besteht darin, NotSupportedException eine-Ausnahme auszulösen.The DataSourceView class's default implementation is to throw a NotSupportedException exception. Wenn Sie die DataSourceView -Klasse erweitern, über ExecuteInsert schreiben Sie die-Methode, wenn die Klasse das Einfügen in den zugrunde liegenden Datenspeicher unterstützt.If you extend the DataSourceView class, override the ExecuteInsert method if your class supports insertion into the underlying data storage.

Gilt für:

Siehe auch