DataSourceView.ExecuteDelete(IDictionary, IDictionary) Méthode

Définition

Exécute une opération de suppression sur la liste des données que l'objet DataSourceView représente.

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

Paramètres

keys
IDictionary

IDictionary d'objet ou clés de ligne à supprimer par l'opération ExecuteDelete(IDictionary, IDictionary).

oldValues
IDictionary

IDictionary de paires nom/valeur qui représentent les éléments de données et leurs valeurs d'origine.

Retours

Nombre d'éléments supprimés du stockage de données sous-jacent.

Exceptions

Exemples

L’exemple de code suivant montre comment une classe qui étend la DataSourceView classe peut remplacer la CanDelete propriété et la ExecuteDelete méthode . Cet exemple de code fait partie d’un exemple plus grand fourni pour la DataSourceView classe .

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

Remarques

Les contrôles liés aux données peuvent déterminer si l’opération ExecuteDelete est prise en charge par un contrôle de source de données en récupérant l’objet à l’aide DataSourceView de la DataSourceControl.GetView méthode et en vérifiant la CanDelete propriété .

Le keys paramètre représente les clés d’objet ou de ligne des données à supprimer. Pour les sources de données qui représentent des données relationnelles, telles que le SqlDataSource contrôle, le keys paramètre est une collection de clés primaires de base de données. Dans d’autres scénarios, le keys paramètre est une collection de paires nom/valeur et est utilisé pour filtrer une liste de données. Toutes les données correspondant à une paire nom/valeur sont supprimées.

Notes

L’implémentation DataSourceView par défaut de la classe consiste à lever une NotSupportedException exception. Si vous étendez la DataSourceView classe, remplacez la ExecuteDelete méthode si votre classe prend en charge la suppression du stockage de données sous-jacent.

S’applique à

Voir aussi