ObjectDataSourceView.ExecuteUpdate メソッド

  • リファレンス

定義

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

UpdateMethod プロパティで指定されたメソッドを keys、values、oldValues の各コレクションで提供された任意のパラメーターを使用して呼び出すことにより、更新操作を実行します。

protected:
 override int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);
protected override int ExecuteUpdate (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);
override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
Protected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

パラメーター

keys
IDictionary

データベース更新操作を実行するために、IDictionary プロパティで使用する主キーの UpdateMethod。 メソッドに関連付けられているキーがない場合は、null を渡します。

values
IDictionary

データベース更新操作を実行するために、IDictionary プロパティで使用する値の UpdateMethod。 メソッドに関連付けられているパラメーターがない場合は、null を渡します。

oldValues
IDictionary

基になるデータ ストア内の元の値を表す IDictionary。 クエリに関連付けられているパラメーターがない場合は、null を渡します。

戻り値

Int32

更新された行数。数が不明の場合は -1。 詳細については、「Update()」を参照してください。

例外

NotSupportedException

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

InvalidOperationException

oldValues が null または空の状態で、ConflictDetection が CompareAllValues に設定されています。

注釈

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

コレクションと values コレクションにkeys含まれる値は評価され、コレクションに含まれるすべての値とUpdateParametersマージされます。 プロパティが ConflictDetection 値に CompareAllValues 設定されている場合、コレクションに oldValues 含まれる値は プロパティで OldValuesParameterFormatString 書式設定され、マージも行われます。

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

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

適用対象

こちらもご覧ください