Partager via


SqlDataSourceView.ExecuteDelete(IDictionary, IDictionary) Méthode

Définition

Exécute une opération de suppression à l'aide de la chaîne DeleteCommand SQL, de tout paramètre spécifié dans la collection DeleteParameters et des valeurs dans les keys et collections oldValues spécifiées.

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

Paramètres

keys
IDictionary

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

oldValues
IDictionary

IDictionary qui contient les valeurs de ligne qui sont évaluées uniquement si la propriété ConflictDetection a la valeur CompareAllValues.

Retours

Une valeur qui représente le nombre de lignes supprimées de la base de données sous-jacente.

Exceptions

SqlDataSource ne peut pas établir de connexion avec la source de données sous-jacente.

- ou -

La propriété ConflictDetection a la valeur CompareAllValues et aucun paramètre oldValues n'est passé.

L'utilisateur actuel ne dispose pas des autorisations appropriées pour accéder à la base de données.

- ou -

L'instance du contrôle est un contrôle AccessDataSource et l'accès au chemin d'accès spécifié pour la propriété DataFile est refusé.

La propriété CanDelete a la valeur false.

- ou -

Un chemin d'accès relatif au moment du design n'a pas été correctement mappé par le concepteur avant l'utilisation d'une instance du contrôle AccessDataSource.

Remarques

La SqlDataSourceView classe implémente la méthode héritée ExecuteDelete pour supprimer des données d’une base de données. Les développeurs de pages et les auteurs de contrôles liés aux données n’appellent pas directement la ExecuteDelete méthode ; à la place, utilisez la méthode exposée Delete publiquement.

Les valeurs contenues dans la keys collection sont évaluées et fusionnées avec toutes les valeurs contenues dans la DeleteParameters collection. Si la ConflictDetection propriété est définie sur la CompareAllValues valeur , les valeurs contenues dans la oldValues collection sont mises en forme avec la OldValuesParameterFormatString propriété et sont également fusionnées.

Avant l’exécution de l’opération de suppression, la OnDeleting méthode est appelée pour déclencher l’événement Deleting . Vous pouvez gérer cet événement pour examiner les valeurs des paramètres et effectuer tout prétraitement avant une suppression.

Pour effectuer une opération de suppression, l’objet SqlDataSourceView génère un DbCommand objet à l’aide du DeleteCommand texte et des propriétés associées DeleteParameters , puis exécute l’objet DbCommand sur la base de données sous-jacente. Une fois l’opération de suppression terminée, la OnDeleted méthode est appelée pour déclencher l’événement Deleted . Vous pouvez gérer cet événement pour examiner les valeurs de retour et les codes d’erreur et effectuer tout post-traitement.

S’applique à

Voir aussi