ObjectDataSourceView.ExecuteInsert(IDictionary) メソッド

  • リファレンス

定義

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

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

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 プロパティで使用されるパラメーターの InsertMethod。 メソッドに関連付けられているパラメーターがない場合は、null を渡します。

戻り値

Int32

挿入された行数。数が不明の場合は -1。 詳細については、「Insert」を参照してください。

例外

NotSupportedException

CanInsert プロパティは、false を返します。

InvalidOperationException

values が null または空です。

注釈

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

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

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

挿入された行数を返す方法の詳細については、「」を参照してください Insert。

適用対象

こちらもご覧ください