ObjectDataSourceView.ExecuteUpdate メソッド

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

ObjectDataSourceView.ExecuteUpdate メソッド

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

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

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Overrides Function
 ExecuteUpdate ( _
    keys As IDictionary, _
    values As IDictionary, _
    oldValues As IDictionary _
) As Integer

Visual Basic (使用法)

Dim keys As IDictionary
Dim values As IDictionary
Dim oldValues As IDictionary
Dim returnValue As Integer

returnValue = Me.ExecuteUpdate(keys, values, oldValues)

C#

protected override int ExecuteUpdate (
    IDictionary keys,
    IDictionary values,
    IDictionary oldValues
)

C++

protected:
virtual int ExecuteUpdate (
    IDictionary^ keys, 
    IDictionary^ values, 
    IDictionary^ oldValues
) override

J#

protected int ExecuteUpdate (
    IDictionary keys, 
    IDictionary values, 
    IDictionary oldValues
)

JScript

protected override function ExecuteUpdate (
    keys : IDictionary, 
    values : IDictionary, 
    oldValues : IDictionary
) : int

パラメータ

keys

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

values

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

oldValues

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

戻り値
削除された行数。数が不明の場合は -1。詳細については、Update のトピックを参照してください。

解説

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

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

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

更新された行数の戻り値の詳細については、Update のトピックを参照してください。

プラットフォーム

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

参照

関連項目
ObjectDataSourceView クラス
ObjectDataSourceView メンバ
System.Web.UI.WebControls 名前空間
Update
UpdateMethod
UpdateParameters
OnUpdating
OnUpdated
Updating
Updated