SqlDataSourceView.ExecuteUpdate(IDictionary, 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 mise à jour à l’aide de la UpdateCommand chaîne SQL, de tous les paramètres qui se trouvent dans la UpdateParameters collection et des valeurs qui se trouvent dans les collections et les collections spécifiésvalueskeysoldValues.
protected:
override int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);protected override int ExecuteUpdate(System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> intProtected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As IntegerParamètres
- keys
- IDictionary
Clé IDictionary primaire à utiliser avec la UpdateCommand propriété pour effectuer l’opération de mise à jour de la base de données. S’il n’existe aucune clé associée à la requête ou si la UpdateCommand propriété n’est pas une requête SQL paramétrée, passez null.
- values
- IDictionary
Valeurs IDictionary à utiliser avec la UpdateCommand propriété pour effectuer l’opération de mise à jour de la base de données. S’il n’existe aucun paramètre associé à la requête ou s’il UpdateCommand ne s’agit pas d’une requête SQL paramétrable, transmettez null.
- oldValues
- IDictionary
Qui IDictionary représente les valeurs d’origine dans la base de données. S’il n’existe aucun paramètre associé à la requête ou si la UpdateCommand propriété n’est pas une requête SQL paramétrable, transmettez null.
Retours
Valeur qui représente le nombre de lignes mises à jour dans 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.
La CanUpdate propriété est false.
Remarques
La SqlDataSourceView classe implémente la méthode héritée ExecuteUpdate pour mettre à jour les données dans 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 ExecuteUpdate méthode ; utilisez plutôt la méthode exposée Update publiquement.
Les valeurs contenues dans les keys collections et values sont évaluées et fusionnées avec toutes les valeurs contenues dans la UpdateParameters collection. Si la ConflictDetection propriété est définie CompareAllValuessur , les valeurs contenues dans la oldValues collection sont mises en forme avec l’objet OldValuesParameterFormatString et sont également fusionnées.
Avant l’exécution de l’opération de mise à jour, la OnUpdating méthode est appelée pour déclencher l’événement Updating . Vous pouvez gérer cet événement pour examiner les valeurs des paramètres et effectuer tout prétraitement avant une mise à jour.
Pour effectuer l’opération, le fichier SqlDataSourceView génère un DbCommand objet à l’aide du UpdateCommand texte et de toutes les propriétés associées UpdateParameters , puis exécute l’objet DbCommand sur la base de données sous-jacente. Une fois l’opération terminée, la OnUpdated méthode est appelée pour déclencher l’événement Updated . Vous pouvez gérer cet événement pour examiner les valeurs de retour et les codes d’erreur et effectuer tout post-traitement.
