SqlCommandBuilder.GetUpdateCommand Méthode

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

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.

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:
 Microsoft::Data::SqlClient::SqlCommand ^ GetUpdateCommand();

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

override this.GetUpdateCommand : unit -> Microsoft.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 .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. Dans le cas contraire, le GetUpdateCommand utilise toujours les informations de l’instruction précédente, ce qui peut ne pas être correct. Les instructions Transact-SQL sont générées pour la première fois lorsque l’application appelle Update ou GetUpdateCommand.

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

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:
 Microsoft::Data::SqlClient::SqlCommand ^ GetUpdateCommand(bool useColumnsForParameterNames);

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

override this.GetUpdateCommand : bool -> Microsoft.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 .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. Dans le cas contraire, le GetUpdateCommand utilise toujours les informations de l’instruction précédente, ce qui peut ne pas être correct. Les instructions Transact-SQL sont générées pour la première fois 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, @p2, et ainsi de suite pour les différents paramètres. Passer true pour le useColumnsForParameterNames paramètre vous permet de forcer le OleDbCommandBuilder à générer des paramètres en fonction des noms de colonnes à la place. Cette opération réussit uniquement si les conditions suivantes sont remplies :

• Le ParameterNameMaxLength retourné par 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 de 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.