SqlCommandBuilder.GetUpdateCommand Méthode

Définition

Espace de noms:

System.Data.SqlClient

Assembly:

System.Data.dll

Obtient l’objet généré SqlCommand automatiquement requis pour effectuer des mises à jour sur la base de données.

Surcharges

Nom	Description
GetUpdateCommand()	Obtient l’objet généré SqlCommand automatiquement requis pour effectuer des mises à jour sur la base de données.
GetUpdateCommand(Boolean)	Obtient l’objet généré SqlCommand automatiquement requis pour effectuer des mises à jour sur la base de données.

Remarques

Une application peut utiliser la GetUpdateCommand méthode à des fins d’information ou de résolution des problèmes, car elle retourne l’objet SqlCommand à exécuter.

Vous pouvez également utiliser GetUpdateCommand comme base d’une commande modifiée. Par exemple, vous pouvez appeler GetUpdateCommand et modifier la CommandTimeout valeur, puis définir explicitement cette valeur sur le SqlDataAdapter.

Une fois l’instruction Transact-SQL générée pour la première fois, l’application doit appeler explicitement RefreshSchema si elle modifie l’instruction de quelque manière que ce soit. Sinon, l’utilisation GetUpdateCommand des informations de l’instruction précédente peut ne pas être correcte. Les instructions Transact-SQL sont d’abord générées lorsque l’application appelle Update ou GetUpdateCommand.

Pour plus d’informations, consultez Génération de commandes avec CommandBuilders.

GetUpdateCommand()

Obtient l’objet généré SqlCommand automatiquement requis pour effectuer des mises à jour sur la base de données.

public:
 System::Data::SqlClient::SqlCommand ^ GetUpdateCommand();

public System.Data.SqlClient.SqlCommand GetUpdateCommand();

override this.GetUpdateCommand : unit -> System.Data.SqlClient.SqlCommand

Public Function GetUpdateCommand () As SqlCommand

Retours

SqlCommand

Objet généré SqlCommand automatiquement requis pour effectuer des mises à jour.

Remarques

Une application peut utiliser la GetUpdateCommand méthode à des fins d’information ou de résolution des problèmes, car elle retourne l’objet SqlCommand à exécuter.

Vous pouvez également utiliser GetUpdateCommand comme base d’une commande modifiée. Par exemple, vous pouvez appeler GetUpdateCommand et modifier la CommandTimeout valeur, puis définir explicitement cette valeur sur le SqlDataAdapter.

Une fois l’instruction Transact-SQL générée pour la première fois, l’application doit appeler explicitement RefreshSchema si elle modifie l’instruction de quelque manière que ce soit. Sinon, l’utilisation GetUpdateCommand des informations de l’instruction précédente peut ne pas être correcte. Les instructions Transact-SQL sont d’abord générées lorsque l’application appelle Update ou GetUpdateCommand.

Pour plus d’informations, consultez Génération de commandes avec CommandBuilders.

Voir aussi

• Connexion et récupération de données dans ADO.NET
• Utilisation du fournisseur de données .NET Framework pour SQL Server
• Vue d'ensemble d’ADO.NET

GetUpdateCommand(Boolean)

Obtient l’objet généré SqlCommand automatiquement requis pour effectuer des mises à jour sur la base de données.

public:
 System::Data::SqlClient::SqlCommand ^ GetUpdateCommand(bool useColumnsForParameterNames);

public System.Data.SqlClient.SqlCommand GetUpdateCommand(bool useColumnsForParameterNames);

override this.GetUpdateCommand : bool -> System.Data.SqlClient.SqlCommand

Public Function GetUpdateCommand (useColumnsForParameterNames As Boolean) As SqlCommand

Paramètres

useColumnsForParameterNames

Boolean

Si true, générez des noms de paramètres correspondant aux noms de colonnes si possible. Si false, générez @p1, @p2et ainsi de suite.

Retours

SqlCommand

Objet généré SqlCommand automatiquement requis pour effectuer des mises à jour.

Remarques

Une application peut utiliser la GetUpdateCommand méthode à des fins d’information ou de résolution des problèmes, car elle retourne l’objet SqlCommand à exécuter.

Vous pouvez également utiliser GetUpdateCommand comme base d’une commande modifiée. Par exemple, vous pouvez appeler GetUpdateCommand et modifier la CommandTimeout valeur, puis définir explicitement cette valeur sur le SqlDataAdapter.

Une fois l’instruction Transact-SQL générée pour la première fois, l’application doit appeler explicitement RefreshSchema si elle modifie l’instruction de quelque manière que ce soit. Sinon, l’utilisation GetUpdateCommand des informations de l’instruction précédente peut ne pas être correcte. Les instructions Transact-SQL sont d’abord générées lorsque l’application appelle Update ou GetUpdateCommand.

Le comportement par défaut, lors de la génération de noms de paramètres, consiste à utiliser @p1, @p2et ainsi de suite pour les différents paramètres. Le passage true du useColumnsForParameterNames paramètre vous permet de forcer la OleDbCommandBuilder génération de paramètres en fonction des noms de colonnes à la place. Cela réussit uniquement si les conditions suivantes sont remplies :

• Retourné ParameterNameMaxLength à partir de l’appel de méthode GetSchema et trouvé dans la DataSourceInformation collection a été spécifié et sa longueur est égale ou supérieure au nom du paramètre généré.

• Le nom du paramètre généré répond aux critères spécifiés dans l’appel ParameterNamePattern de méthode GetSchema et trouvé dans l’expression régulière de la DataSourceInformation collection.

• Un ParameterMarkerFormat retour de l’appel de méthode GetSchema et trouvé dans la DataSourceInformation collection est spécifié.

Pour plus d’informations, consultez Génération de commandes avec CommandBuilders.

Voir aussi

• Connexion et récupération de données dans ADO.NET
• Utilisation du fournisseur de données .NET Framework pour SQL Server
• Vue d'ensemble d’ADO.NET