ObjectDataSourceView.ExecuteInsert メソッド

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

ObjectDataSourceView.ExecuteInsert メソッド

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

指定した values コレクションを使用して、InsertMethod プロパティで指定されたビジネス オブジェクト メソッドを呼び出すことで、挿入操作を実行します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim values As IDictionary
Dim returnValue As Integer

returnValue = Me.ExecuteInsert(values)

C#

protected override int ExecuteInsert (
    IDictionary values
)

C++

protected:
virtual int ExecuteInsert (
    IDictionary^ values
) override

J#

protected int ExecuteInsert (
    IDictionary values
)

JScript

protected override function ExecuteInsert (
    values : IDictionary
) : int

パラメータ

values

挿入操作を実行するために InsertMethod プロパティで使用されるパラメータの IDictionary。メソッドに関連付けられているパラメータがない場合は、null 参照 (Visual Basic では Nothing) を渡します。

戻り値
挿入された行数。数が不明の場合は -1。詳細については、Insert のトピックを参照してください。

例外

例外の種類	条件
NotSupportedException	CanInsert プロパティは、false を返します。

解説

ObjectDataSourceView クラスが、継承された ExecuteInsert メソッドを実装し、ビジネス オブジェクトを使用して基になるデータ ストアにデータを挿入しています。ページ開発者およびデータ連結コントロールの作成者は、ExecuteInsert メソッドを直接呼び出す代わりに、パブリックとして公開された Insert メソッドを使用します。

挿入を実行する前に、OnInserting メソッドが呼び出されて Inserting イベントが発生します。このイベントを処理することで、パラメータの値を調べ、Insert メソッドを呼び出す前に処理を実行できます。

挿入操作を実行するために、ObjectDataSourceView コントロールはリフレクションを使用して、InsertMethod プロパティおよび values コレクション内の任意の関連するパラメータで指定されたメソッドを呼び出し、実行します。操作が完了した後、OnInserted メソッドが呼び出されて Inserted イベントが発生します。このイベントを処理することにより戻り値 (エラー コード) を調べ、後処理を実行できます。

挿入された行数の戻り値の詳細については、Insert のトピックを参照してください。

プラットフォーム

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

参照

関連項目
ObjectDataSourceView クラス
ObjectDataSourceView メンバ
System.Web.UI.WebControls 名前空間
Insert
InsertMethod
InsertParameters
OnInserting
OnInserted
Inserting
Inserted