DataSourceView.ExecuteInsert メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DataSourceView.ExecuteInsert メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

DataSourceView オブジェクトで表されたデータのリストに対して、挿入操作を実行します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Function
 ExecuteInsert ( _
    values As IDictionary _
) As Integer

Visual Basic (使用法)

Dim values As IDictionary
Dim returnValue As Integer

returnValue = Me.ExecuteInsert(values)

protected virtual int ExecuteInsert (
    IDictionary values
)

C++

protected:
virtual int ExecuteInsert (
    IDictionary^ values
)

protected int ExecuteInsert (
    IDictionary values
)

JScript

protected function ExecuteInsert (
    values : IDictionary
) : int

パラメータ

values: 挿入操作で使用する名前/値ペアで構成される IDictionary。

戻り値
基になるデータストレージに挿入された項目数。

例外

例外の種類	条件
NotSupportedException	ExecuteInsert 操作は DataSourceView ではサポートされません。

解説

データバインドコントロールでは、GetView メソッドを使用して DataSourceView オブジェクトを取得し、CanInsert プロパティを確認することにより、ExecuteInsert 操作がデータソースコントロールでサポートされるかどうかを判断できます。

values パラメータは、データ列またはデータフィールドと、それに対応する挿入値を表す一連の名前/値ペアです。

メモ
DataSourceView クラスの既定の実装では、NotSupportedException 例外がスローされます。DataSourceView クラスを拡張する場合、そのクラスで基になるデータストレージへの挿入をサポートするには、ExecuteInsert メソッドをオーバーライドします。

使用例

DataSourceView クラスを拡張するクラスで、CanInsert プロパティと ExecuteInsert メソッドをオーバーライドする方法を次のコード例に示します。このコード例は、DataSourceView クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' 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

// 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();
}