OleDbCommandBuilder.GetUpdateCommand Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient l’objet généré OleDbCommand automatiquement requis pour effectuer des mises à jour à la source de données.
Surcharges
| Nom | Description |
|---|---|
| GetUpdateCommand() |
Obtient l’objet généré OleDbCommand automatiquement requis pour effectuer des mises à jour à la source de données. |
| GetUpdateCommand(Boolean) |
Obtient l’objet généré OleDbCommand automatiquement requis pour effectuer des mises à jour à la source de données, éventuellement à l’aide de colonnes pour les noms de paramètres. |
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 OleDbCommand à 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 OleDbDataAdapter.
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 sera toujours utilisée, ce qui peut ne pas être correct. Les instructions SQL sont d’abord générées lorsque l’application appelle ou UpdateCommandGetUpdateCommand.
GetUpdateCommand()
Obtient l’objet généré OleDbCommand automatiquement requis pour effectuer des mises à jour à la source de données.
public:
System::Data::OleDb::OleDbCommand ^ GetUpdateCommand();
public System.Data.OleDb.OleDbCommand GetUpdateCommand();
member this.GetUpdateCommand : unit -> System.Data.OleDb.OleDbCommand
override this.GetUpdateCommand : unit -> System.Data.OleDb.OleDbCommand
Public Function GetUpdateCommand () As OleDbCommand
Retours
Objet généré OleDbCommand 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 OleDbCommand à 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 OleDbDataAdapter.
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 sera toujours utilisée, ce qui peut ne pas être correct. Les instructions SQL sont d’abord générées lorsque l’application appelle ou UpdateCommandGetUpdateCommand.
Voir aussi
S’applique à
GetUpdateCommand(Boolean)
Obtient l’objet généré OleDbCommand automatiquement requis pour effectuer des mises à jour à la source de données, éventuellement à l’aide de colonnes pour les noms de paramètres.
public:
System::Data::OleDb::OleDbCommand ^ GetUpdateCommand(bool useColumnsForParameterNames);
public System.Data.OleDb.OleDbCommand GetUpdateCommand(bool useColumnsForParameterNames);
override this.GetUpdateCommand : bool -> System.Data.OleDb.OleDbCommand
Public Function GetUpdateCommand (useColumnsForParameterNames As Boolean) As OleDbCommand
Paramètres
- useColumnsForParameterNames
- Boolean
Si true, générez des noms de paramètres correspondant aux noms de colonnes, s’il est possible. Si false, générez @p1, @p2et ainsi de suite.
Retours
Objet généré OleDbCommand 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 OleDbCommand à 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 OleDbDataAdapter.
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 sera toujours utilisée, ce qui peut ne pas être correct. Les instructions SQL sont d’abord générées lorsque l’application appelle ou UpdateCommandGetUpdateCommand.
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 :
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é.