Cette documentation est archivée et n’est pas conservée.

SqlDataSourceView.ExecuteUpdate, méthode

Remarque : cette méthode est nouvelle dans le .NET Framework version 2.0.

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.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

protected override int ExecuteUpdate (
	IDictionary keys,
	IDictionary values,
	IDictionary oldValues
)
protected int ExecuteUpdate (
	IDictionary keys, 
	IDictionary values, 
	IDictionary oldValues
)
protected override function ExecuteUpdate (
	keys : IDictionary, 
	values : IDictionary, 
	oldValues : IDictionary
) : int

Paramètres

keys

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 référence Null (Nothing en Visual Basic).

values

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 référence Null (Nothing en Visual Basic).

oldValues

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 référence Null (Nothing en Visual Basic).

Valeur de retour

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

Type d'exceptionCondition

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 est false.

La classe SqlDataSourceView implémente la méthode ExecuteUpdate héritée pour mettre à jour 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 méthode ExecuteUpdate ; ils utilisent la méthode Update publiquement exposée.

Les valeurs contenues dans les collections keys et values sont évaluées et fusionnées avec toutes les valeurs contenues par la collection UpdateParameters. Si la propriété ConflictDetection a la valeur CompareAllValues, les valeurs contenues dans la collection oldValues sont mises en forme avec OldValuesParameterFormatString et sont également fusionnées.

Avant que l'opération de mise à jour ne soit effectuée, la méthode OnUpdating 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 exécuter l'opération, SqlDataSourceView génère un objet DbCommand à l'aide du texte UpdateCommand et de toute propriété UpdateParameters associée, puis exécute l'objet DbCommand sur la base de données sous-jacente. Lorsque l'opération est terminée, la méthode OnUpdated 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, ainsi que pour effectuer tout post-traitement.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Afficher: