DataSourceView.ExecuteDelete メソッドとは何？わかりやすく解説 Weblio辞書

.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)

protected virtual int ExecuteDelete (
    IDictionary keys,
    IDictionary oldValues
)

C++

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

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

// 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();
}