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.
Exécute une opération de mise à jour à l'aide de la chaîne UpdateCommand SQL, tout paramètre de la collection UpdateParameters ainsi que les valeurs se trouvant dans les collections keys, values et oldValues spécifiées.
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
IDictionary de clés primaires à utiliser avec la propriété UpdateCommand pour exécuter l'opération de mise à jour de la base de données. S'il n'y a pas de clé associée à la requête ou si la propriété UpdateCommand n'est pas une requête SQL paramétrée, passez null.
- values
- IDictionary
IDictionary de valeurs à utiliser avec la propriété UpdateCommand pour exécuter l'opération de mise à jour de la base de données. S'il n'y a pas de paramètre associé à la requête ou si la propriété UpdateCommand n'est pas une requête SQL paramétrée, passez null.
- oldValues
- IDictionary
IDictionary qui représente les valeurs d'origine de la base de données. S'il n'y a pas de paramètre associé à la requête ou si la propriété UpdateCommand n'est pas une requête SQL paramétrée, passez null.
Retours
Une valeur qui représente le nombre de lignes mises à jour dans 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 n'a pas les autorisations appropriées pour accéder à la base de données.
La propriété CanUpdate a la valeur 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 ; à la place, utilisez la méthode exposée Update publiquement.
Les valeurs contenues dans les keys collections et sont values évaluées et fusionnées avec toutes les valeurs contenues dans la UpdateParameters collection. Si la ConflictDetection propriété a la CompareAllValuesvaleur , les valeurs contenues dans la oldValues collection sont mises en forme avec et OldValuesParameterFormatString é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, génère SqlDataSourceView un DbCommand objet à l’aide du UpdateCommand texte et des 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.
