DataSourceView.ExecuteDelete(IDictionary, IDictionary) Metoda

Definicja

Wykonuje operację usuwania na liście danych reprezentowanych przez DataSourceView obiekt.

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

Parametry

keys
IDictionary

Obiekt IDictionary lub klucze wiersza, które mają zostać usunięte przez operację ExecuteDelete(IDictionary, IDictionary) .

oldValues
IDictionary

Para IDictionary nazwa/wartość reprezentująca elementy danych i ich oryginalne wartości.

Zwraca

Liczba elementów, które zostały usunięte z magazynu danych bazowych.

Wyjątki

Operacja nie jest obsługiwana ExecuteDelete(IDictionary, IDictionary) przez element DataSourceView.

Przykłady

W poniższym przykładzie kodu pokazano, jak klasa rozszerzająca DataSourceView klasę może zastąpić CanDelete właściwość i metodę ExecuteDelete . Ten przykład kodu jest częścią większego przykładu udostępnionego DataSourceView dla klasy .

// 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

Uwagi

Kontrolki powiązane z danymi mogą określać, ExecuteDelete czy operacja jest obsługiwana przez kontrolkę źródła danych, pobierając DataSourceView obiekt przy użyciu DataSourceControl.GetView metody i sprawdzając CanDelete właściwość .

Parametr keys reprezentuje obiekt lub klucze wierszy danych do usunięcia. W przypadku źródeł danych reprezentujących dane relacyjne, takich jak kontrolka SqlDataSource , keys parametr jest kolekcją kluczy podstawowych bazy danych. W innych scenariuszach keys parametr jest kolekcją par nazwa/wartość i służy do filtrowania listy danych. Wszystkie dane pasujące do pary nazwa/wartość są usuwane.

Uwaga

Domyślna DataSourceView implementacja klasy to zgłoszenie wyjątku NotSupportedException . Jeśli rozszerzysz klasę DataSourceView , przesłoń metodę ExecuteDelete , jeśli klasa obsługuje usuwanie z magazynu danych bazowych.

Dotyczy

Zobacz też