SqlDataSourceView.ExecuteInsert メソッド

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

SqlDataSourceView.ExecuteInsert メソッド

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

InsertCommand SQL 文字列、InsertParameters コレクションで指定した任意のパラメータ、および指定した values コレクション内の値を使用して、挿入操作を実行します。

名前空間: 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

データベースへの挿入操作を実行するために、InsertCommand プロパティで使用される値の IDictionary。クエリに関連付けられているパラメータがないか、InsertCommand プロパティがパラメータ化された SQL クエリでない場合は、null 参照 (Visual Basic では Nothing) を渡します。

戻り値
基になるデータベースに挿入された行数を表す値。

例外

例外の種類	条件
InvalidOperationException	SqlDataSource が、基になるデータ ソースとの接続を確立できません。
HttpException	現在のユーザーには、データベースにアクセスできる正しいアクセス許可がありません。
NotSupportedException	CanInsert プロパティが false です。

解説

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

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

挿入操作を実行するために、SqlDataSourceView オブジェクトは、InsertCommand テキストおよび関連する任意の InsertParameters プロパティを使用して、DbCommand オブジェクトを構築し、基になるデータベースに対して DbCommand オブジェクトを実行します。挿入が完了した後、OnInserted メソッドが呼び出されて Inserted イベントが発生します。このイベントを処理することにより、戻り値とエラー コードを調べ、後処理を実行できます。

プラットフォーム

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

参照

関連項目
SqlDataSourceView クラス
SqlDataSourceView メンバ
System.Web.UI.WebControls 名前空間
Insert
InsertCommand
InsertParameters