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

定義

名前空間:

System.Web.UI

アセンブリ:

System.Web.dll

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。

戻り値

Int32

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

例外

NotSupportedException

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 します。

こちらもご覧ください

• CanDelete