OleDbCommandBuilder.GetInsertCommand 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 insertions à la source de données.
Surcharges
| Nom | Description |
|---|---|
| GetInsertCommand() |
Obtient l’objet généré OleDbCommand automatiquement requis pour effectuer des insertions à la source de données. |
| GetInsertCommand(Boolean) |
Obtient l’objet généré OleDbCommand automatiquement requis pour effectuer des insertions à la source de données. |
Remarques
Une application peut utiliser la GetInsertCommand méthode à des fins d’information ou de résolution des problèmes, car elle retourne le texte de l’objet OleDbCommand à exécuter.
Vous pouvez également utiliser GetInsertCommand comme base d’une commande modifiée. Par exemple, vous pouvez appeler GetInsertCommand 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 GetInsertCommand 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 UpdateCommandGetInsertCommand.
GetInsertCommand()
Obtient l’objet généré OleDbCommand automatiquement requis pour effectuer des insertions à la source de données.
public:
System::Data::OleDb::OleDbCommand ^ GetInsertCommand();public System.Data.OleDb.OleDbCommand GetInsertCommand();member this.GetInsertCommand : unit -> System.Data.OleDb.OleDbCommandoverride this.GetInsertCommand : unit -> System.Data.OleDb.OleDbCommandPublic Function GetInsertCommand () As OleDbCommandRetours
Objet généré OleDbCommand automatiquement pour effectuer des insertions.
Remarques
Une application peut utiliser la GetInsertCommand méthode à des fins d’information ou de résolution des problèmes, car elle retourne le texte de l’objet OleDbCommand à exécuter.
Vous pouvez également utiliser GetInsertCommand comme base d’une commande modifiée. Par exemple, vous pouvez appeler GetInsertCommand 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 GetInsertCommand 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 UpdateCommandGetInsertCommand.
Voir aussi
S’applique à
GetInsertCommand(Boolean)
Obtient l’objet généré OleDbCommand automatiquement requis pour effectuer des insertions à la source de données.
public:
System::Data::OleDb::OleDbCommand ^ GetInsertCommand(bool useColumnsForParameterNames);public System.Data.OleDb.OleDbCommand GetInsertCommand(bool useColumnsForParameterNames);override this.GetInsertCommand : bool -> System.Data.OleDb.OleDbCommandPublic Function GetInsertCommand (useColumnsForParameterNames As Boolean) As OleDbCommandParamè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 pour effectuer des insertions.
Remarques
Une application peut utiliser la GetInsertCommand méthode à des fins d’information ou de résolution des problèmes, car elle retourne le texte de l’objet OleDbCommand à exécuter.
Vous pouvez également utiliser GetInsertCommand comme base d’une commande modifiée. Par exemple, vous pouvez appeler GetInsertCommand 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 GetInsertCommand 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 UpdateCommandGetInsertCommand.
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é.