SqlCommandBuilder.GetUpdateCommand Méthode

Définition

Espace de noms:

System.Data.SqlClient

Assembly:

System.Data.SqlClient.dll

Paquet:

System.Data.SqlClient v4.8.6

Obtient l'objet SqlCommand généré automatiquement, qui est requis pour effectuer des mises à jour au niveau de la base de données.

Surcharges

GetUpdateCommand()	Obtient l'objet SqlCommand généré automatiquement, qui est requis pour effectuer des mises à jour au niveau de la base de données.
GetUpdateCommand(Boolean)	Obtient l'objet SqlCommand généré automatiquement, qui est requis pour effectuer des mises à jour au niveau de 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 la définir explicitement sur le SqlDataAdapter.

Une fois l’instruction Transact-SQL générée pour la première fois, l’application doit appeler RefreshSchema explicitement si elle modifie l’instruction de quelque manière que ce soit. Sinon, le GetUpdateCommand utilise toujours les informations de l’instruction précédente, ce qui peut ne pas être correct. 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 SqlCommand généré automatiquement, qui est requis pour effectuer des mises à jour au niveau de 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 SqlCommand généré automatiquement qui est 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 la définir explicitement sur le SqlDataAdapter.

Une fois l’instruction Transact-SQL générée pour la première fois, l’application doit appeler RefreshSchema explicitement si elle modifie l’instruction de quelque manière que ce soit. Sinon, le GetUpdateCommand utilise toujours les informations de l’instruction précédente, ce qui peut ne pas être correct. 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 SqlCommand généré automatiquement, qui est requis pour effectuer des mises à jour au niveau de 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 la valeur est true, génère des noms de paramètres correspondant aux noms de colonnes, dans la mesure du possible. Si la valeur est false, génère @p1, @p2, etc.

Retours

SqlCommand

Objet SqlCommand généré 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 la définir explicitement sur le SqlDataAdapter.

Une fois l’instruction Transact-SQL générée pour la première fois, l’application doit appeler RefreshSchema explicitement si elle modifie l’instruction de quelque manière que ce soit. Sinon, le GetUpdateCommand utilise toujours les informations de l’instruction précédente, ce qui peut ne pas être correct. 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 pour le useColumnsForParameterNames paramètre vous permet de forcer le OleDbCommandBuilder à générer des paramètres basés sur les noms de colonnes à la place. Cette opération réussit uniquement si les conditions suivantes sont remplies :

• Le ParameterNameMaxLength retourné à 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 de paramètre généré.

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

• Un ParameterMarkerFormat retourné à partir 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