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.
Effectue une opération de suppression à l’aide de la DeleteCommand chaîne SQL, des paramètres spécifiés dans la DeleteParameters collection et des valeurs figurant dans les collections et spécifiées keysoldValues .
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
Valeurs IDictionary de clé d’objet ou de ligne pour l’opération ExecuteDelete(IDictionary, IDictionary) à supprimer.
- oldValues
- IDictionary
Valeur IDictionary qui contient des valeurs de ligne qui sont évaluées uniquement si la ConflictDetection propriété est définie sur la CompareAllValues valeur.
Retours
Valeur qui représente le nombre de lignes supprimées de la base de données sous-jacente.
Exceptions
Impossible SqlDataSource d’établir une connexion avec la source de données sous-jacente.
- ou -
La ConflictDetection propriété est définie sur la CompareAllValues valeur et aucun paramètre n’est oldValues passé.
L’utilisateur actuel n’a pas les autorisations appropriées pour accéder à la base de données.
- ou -
L’instance du contrôle est un AccessDataSource contrôle et l’accès est refusé au chemin spécifié pour la DataFile propriété.
La CanDelete propriété est false.
- ou -
Un chemin relatif au moment du design n’a pas été mappé correctement par le concepteur avant d’utiliser une instance du AccessDataSource contrôle.
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 ; utilisez plutôt 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 la suppression.
Pour effectuer une opération de suppression, l’objet SqlDataSourceView génère un DbCommand objet à l’aide du DeleteCommand texte et de toutes les 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.
