DataSourceView.ExecuteDelete(IDictionary, IDictionary) メソッド

定義

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

protected:
 virtual int ExecuteDelete(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ oldValues);
protected virtual int ExecuteDelete (System.Collections.IDictionary keys, System.Collections.IDictionary oldValues);
abstract member ExecuteDelete : System.Collections.IDictionary * System.Collections.IDictionary -> int
override this.ExecuteDelete : System.Collections.IDictionary * System.Collections.IDictionary -> int
Protected Overridable Function ExecuteDelete (keys As IDictionary, oldValues As IDictionary) As Integer

パラメーター

keys
IDictionary

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

oldValues
IDictionary

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

戻り値

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

例外

ExecuteDelete(IDictionary, IDictionary) 操作は DataSourceView ではサポートされません。

次のコード例は、 クラスを拡張するクラスが DataSourceView プロパティと メソッドを CanDelete オーバーライドする方法を ExecuteDelete 示しています。 このコード例は、DataSourceView クラスのために提供されている大規模な例の一部です。

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

注釈

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

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

注意

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

適用対象

こちらもご覧ください