SqlDataSourceView.ExecuteInsert(IDictionary) メソッド

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls
アセンブリ:
System.Web.dll

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

protected:
 override int ExecuteInsert(System::Collections::IDictionary ^ values);
protected override int ExecuteInsert (System.Collections.IDictionary values);
override this.ExecuteInsert : System.Collections.IDictionary -> int
Protected Overrides Function ExecuteInsert (values As IDictionary) As Integer

パラメーター

values
IDictionary

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

戻り値

Int32

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

例外

InvalidOperationException

SqlDataSource が、基になるデータ ソースとの接続を確立できません。

HttpException

現在のユーザーには、データベースにアクセスできる正しいアクセス許可がありません。

NotSupportedException

CanInsert プロパティが false です。

注釈

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

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

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

適用対象

こちらもご覧ください