SqlDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Méthode

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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 -> int
Protected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

Paramè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

Int32

Une valeur qui représente le nombre de lignes mises à jour dans la base de données sous-jacente.

Exceptions

InvalidOperationException

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é.

HttpException

L'utilisateur actuel n'a pas les autorisations appropriées pour accéder à la base de données.

NotSupportedException

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.

S’applique à

Voir aussi