DataSourceView.ExecuteInsert メソッド

.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)

C#

protected virtual int ExecuteInsert (
    IDictionary values
)

C++

protected:
virtual int ExecuteInsert (
    IDictionary^ values
)

J#

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

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataSourceView クラス
DataSourceView メンバ
System.Web.UI 名前空間
CanInsert