SqlDataSourceView.ExecuteDelete(IDictionary, IDictionary) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> intProtected Overrides Function ExecuteDelete (keys As IDictionary, oldValues As IDictionary) As IntegerParamè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.
