DbCommandBuilder.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é DbCommand automatiquement requis pour effectuer des insertions à la source de données.
Surcharges
| Nom | Description |
|---|---|
| GetInsertCommand() |
Obtient l’objet généré DbCommand automatiquement requis pour effectuer des insertions à la source de données. |
| GetInsertCommand(Boolean) |
Obtient l’objet généré DbCommand automatiquement requis pour effectuer des insertions à la source de données, éventuellement à l’aide de colonnes pour les noms de paramètres. |
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 DbCommand à exécuter.
Vous pouvez également utiliser GetInsertCommand comme base d’une commande modifiée. Par exemple, vous pouvez appeler GetInsertCommand 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 GetInsertCommand 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 GetInsertCommand.
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. Si la version surchargée de vous permet de GetInsertCommand spécifier ce comportement, vous pouvez générer des DbCommandBuilder paramètres en fonction des noms de colonnes à la place.
GetInsertCommand()
Obtient l’objet généré DbCommand automatiquement requis pour effectuer des insertions à la source de données.
public:
System::Data::Common::DbCommand ^ GetInsertCommand();public System.Data.Common.DbCommand GetInsertCommand();member this.GetInsertCommand : unit -> System.Data.Common.DbCommandPublic Function GetInsertCommand () As DbCommandRetours
Objet généré DbCommand 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 DbCommand à exécuter.
Vous pouvez également utiliser GetInsertCommand comme base d’une commande modifiée. Par exemple, vous pouvez appeler GetInsertCommand 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 GetInsertCommand 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 GetInsertCommand.
Voir aussi
S’applique à
GetInsertCommand(Boolean)
Obtient l’objet généré DbCommand automatiquement requis pour effectuer des insertions à la source de données, éventuellement à l’aide de colonnes pour les noms de paramètres.
public:
System::Data::Common::DbCommand ^ GetInsertCommand(bool useColumnsForParameterNames);public System.Data.Common.DbCommand GetInsertCommand(bool useColumnsForParameterNames);member this.GetInsertCommand : bool -> System.Data.Common.DbCommandPublic Function GetInsertCommand (useColumnsForParameterNames As Boolean) As DbCommandParamètres
- useColumnsForParameterNames
- Boolean
Si true, générez des noms de paramètres correspondant aux noms de colonnes, si possible. Si false, générez @p1, @p2et ainsi de suite.
Retours
Objet généré DbCommand 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 DbCommand à exécuter.
Vous pouvez également utiliser GetInsertCommand comme base d’une commande modifiée. Par exemple, vous pouvez appeler GetInsertCommand 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 GetInsertCommand 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 GetInsertCommand.
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é.