SqlDataSourceView.ExecuteInsert(IDictionary) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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 -> intProtected Overrides Function ExecuteInsert (values As IDictionary) As Integerパラメーター
- values
- IDictionary
データベース挿入操作を実行するために InsertCommand プロパティで使用される値のIDictionary。 クエリに関連付けられているパラメーターがない場合、または InsertCommand プロパティがパラメーター化された SQL クエリでない場合は、 null渡します。
返品
基になるデータベースに挿入された行の数を表す値。
例外
SqlDataSourceは、基になるデータ ソースとの接続を確立できません。
現在のユーザーは、データベースにアクセスするための適切なアクセス許可を持っていません。
CanInsert プロパティはfalse。
注釈
SqlDataSourceView クラスは、継承されたExecuteInsert メソッドを実装して、データベースにデータを挿入します。 ページ開発者とデータ バインド コントロールの作成者は、 ExecuteInsert メソッドを直接呼び出しません。代わりに、パブリックに公開されている Insert メソッドを使用します。
挿入操作が実行される前に、 OnInserting メソッドが呼び出され、 Inserting イベントが発生します。 このイベントを処理して、パラメーターの値を調べ、挿入前に前処理を実行できます。
挿入操作を実行するために、SqlDataSourceView オブジェクトは、InsertCommand テキストと関連するInsertParametersプロパティを使用してDbCommand オブジェクトをビルドし、基になるデータベースに対してDbCommand オブジェクトを実行します。 挿入が完了すると、Inserted イベントを発生させるために OnInserted メソッドが呼び出されます。 このイベントを処理して、戻り値とエラー コードを調べ、後処理を実行できます。