DbCommandBuilder.GetUpdateCommand Méthode

public:
 System::Data::Common::DbCommand ^ GetUpdateCommand();

public System.Data.Common.DbCommand GetUpdateCommand();

member this.GetUpdateCommand : unit -> System.Data.Common.DbCommand

Public Function GetUpdateCommand () As DbCommand

Retours

Objet généré DbCommand 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 DbCommand à exécuter.

Vous pouvez également utiliser GetUpdateCommand comme base d’une commande modifiée. Par exemple, vous pouvez appeler GetUpdateCommand et modifier le texte de la commande, puis définir explicitement celui-ci sur le DbDataAdapter.

Une fois l’instruction SQL générée pour la première fois, l’application doit appeler RefreshSchema explicitement s’il 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 SQL sont d’abord générées lorsque l’application appelle Update ou GetUpdateCommand.

Voir aussi

• Génération de commandes avec CommandBuilders
• Vue d'ensemble d’ADO.NET

public:
 System::Data::Common::DbCommand ^ GetUpdateCommand(bool useColumnsForParameterNames);

public System.Data.Common.DbCommand GetUpdateCommand(bool useColumnsForParameterNames);

member this.GetUpdateCommand : bool -> System.Data.Common.DbCommand

Public Function GetUpdateCommand (useColumnsForParameterNames As Boolean) As DbCommand

Paramètres

Retours

Objet généré DbCommand 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 DbCommand à exécuter.

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

Une fois l’instruction SQL générée pour la première fois, l’application doit appeler RefreshSchema explicitement s’il 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 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 DbCommandBuilder génération de paramètres en fonction des noms de colonnes à la place. La génération des paramètres basés sur les noms de colonnes réussit uniquement si les conditions suivantes sont remplies :

• La ParameterNameMaxLength longueur a été spécifiée 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’expression ParameterNamePattern régulière.

• A ParameterMarkerFormat est spécifié.

Voir aussi

• Génération de commandes avec CommandBuilders
• Vue d'ensemble d’ADO.NET