DataSourceView.ExecuteInsert(IDictionary) メソッド


DataSourceView オブジェクトで表されたデータのリストに対して、挿入操作を実行します。Performs an insert operation on the list of data that the DataSourceView object represents.

 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



挿入操作で使用する名前/値ペアで構成される IDictionaryAn IDictionary of name/value pairs used during an insert operation.


基になるデータ ストレージに挿入された項目数。The number of items that were inserted into the underlying data storage.


ExecuteInsert(IDictionary) 操作は DataSourceView ではサポートされません。The ExecuteInsert(IDictionary) operation is not supported by the DataSourceView.

次のコード例は、 DataSourceViewクラスを拡張するクラスがCanInsertプロパティとExecuteInsertメソッドをオーバーライドできる方法を示しています。The following code example demonstrates how a class that extends the DataSourceView class can override the CanInsert property and the ExecuteInsert method. このコード例は、 DataSourceViewクラスに対して提供される大規模な例の一部です。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
      Return False
   End Get
End Property

Protected Overrides Function ExecuteInsert(values As IDictionary) As Integer
   Throw New NotSupportedException()
End Function 'ExecuteInsert


データバインドコントロールExecuteInsertは、 GetViewメソッドを使用してDataSourceViewオブジェクトを取得し、 CanInsertプロパティをチェックすることによって、操作がデータソースコントロールによってサポートされているかどうかを判断できます。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.

パラメーター valuesは、データ列、フィールド、および挿入する対応する値を表す名前と値のペアのセットです。The values parameter is a set of name/value pairs that represents data columns or fields and corresponding values to insert.


クラスDataSourceViewの既定の実装では、 NotSupportedException例外がスローされます。The DataSourceView class's default implementation is to throw a NotSupportedException exception. クラスを拡張DataSourceViewする場合は、クラスExecuteInsertが基になるデータストレージへの挿入をサポートしている場合は、メソッドをオーバーライドします。If you extend the DataSourceView class, override the ExecuteInsert method if your class supports insertion into the underlying data storage.