ObjectDataSourceView.ExecuteDelete メソッド

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

ObjectDataSourceView.ExecuteDelete メソッド

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

DeleteMethod メソッドおよび指定した keys コレクションと oldValues コレクションを使用して、削除操作を実行します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

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

returnValue = Me.ExecuteDelete(keys, oldValues)

C#

protected override int ExecuteDelete (
    IDictionary keys,
    IDictionary oldValues
)

C++

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

J#

protected int ExecuteDelete (
    IDictionary keys, 
    IDictionary oldValues
)

JScript

protected override function ExecuteDelete (
    keys : IDictionary, 
    oldValues : IDictionary
) : int

パラメータ

keys

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

oldValues

ConflictDetection プロパティが CompareAllValues フィールドに設定されている場合にだけ評価される行の値を格納している IDictionary。

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

例外

例外の種類	条件
NotSupportedException	CanDelete プロパティは、false を返します。
InvalidOperationException	ConflictDetection プロパティが CompareAllValues 値に設定され、oldValues コレクション内の値が渡されていません。

解説

ObjectDataSourceView クラスは、継承された ExecuteDelete メソッドを実装し、ビジネス オブジェクトを使用して基になるデータ ストアからデータを削除します。ページ開発者およびデータ連結コントロールの作成者は、ExecuteDelete メソッドを直接呼び出す代わりに、パブリックとして公開された Delete メソッドを使用します。

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

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

プラットフォーム

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 名前空間
Delete
DeleteMethod
DeleteParameters
OnDeleting
OnDeleted
Deleting
Deleted