DataSourceView.ExecuteDelete メソッド

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

DataSourceView.ExecuteDelete メソッド

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

DataSourceView オブジェクトで表されたデータのリストに対して、削除操作を実行します。

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

Visual Basic (宣言)

Protected Overridable 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 virtual int ExecuteDelete (
    IDictionary keys,
    IDictionary oldValues
)

C++

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

J#

protected int ExecuteDelete (
    IDictionary keys, 
    IDictionary oldValues
)

JScript

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

パラメータ

keys

ExecuteDelete 操作で削除するオブジェクト キーまたは行キーで構成される IDictionary。

oldValues

データ要素およびその元の値を表す名前/値ペアで構成される IDictionary。

戻り値
基になるデータ ストレージから削除された項目数。

例外

例外の種類	条件
NotSupportedException	ExecuteDelete 操作は DataSourceView ではサポートされません。

解説

データ バインド コントロールでは、DataSourceControl.GetView メソッドを使用して DataSourceView オブジェクトを取得し、CanDelete プロパティを確認することにより、ExecuteDelete 操作がデータ ソース コントロールでサポートされるかどうかを判断できます。

keys パラメータは、削除するデータのオブジェクト キーまたは行キーを表します。SqlDataSource コントロールなど、リレーショナル データを表すデータ ソースの場合、keys パラメータはデータベースの主キーのコレクションです。その他の場合は、keys パラメータは名前/値ペアであり、データのリストをフィルタ処理するために使用されます。名前/値ペアと一致するすべてのデータが削除されます。

メモ
DataSourceView クラスの既定の実装では、NotSupportedException 例外がスローされます。DataSourceView クラスを拡張する場合、そのクラスで基になるデータ ストレージからの削除をサポートするには、ExecuteDelete メソッドをオーバーライドします。

使用例

DataSourceView クラスを拡張するクラスで、CanDelete プロパティと ExecuteDelete メソッドをオーバーライドする方法を次のコード例に示します。このコード例は、DataSourceView クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' The CsvDataSourceView does not currently
' permit deletion. You can modify or extend
' this sample to do so.
Public Overrides ReadOnly
 Property CanDelete() As Boolean
   Get
      Return False
   End Get
End Property

Protected Overrides Function
 ExecuteDelete(keys As IDictionary, values As
 IDictionary) As Integer
   Throw New NotSupportedException()
End Function 'ExecuteDelete

C#

// The CsvDataSourceView does not currently
// permit deletion. You can modify or extend
// this sample to do so.
public override bool CanDelete {
    get {
        return false;
    }
}
protected override int ExecuteDelete(IDictionary
 keys, IDictionary values)
{
    throw new NotSupportedException();
}

プラットフォーム

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

参照

関連項目
DataSourceView クラス
DataSourceView メンバ
System.Web.UI 名前空間
CanDelete