Partager via


DbCommandBuilder.GetInsertCommand Méthode

Définition

Obtient l'objet DbCommand généré automatiquement, qui est requis pour effectuer des insertions au niveau de la source de données.

Surcharges

GetInsertCommand()

Obtient l'objet DbCommand généré automatiquement, qui est requis pour effectuer des insertions au niveau de la source de données.

GetInsertCommand(Boolean)

Obtient l'objet DbCommand généré automatiquement, qui est requis pour effectuer des insertions au niveau de la source de données, en utilisant éventuellement des 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 le texte de commande, puis le définir explicitement sur le DbDataAdapter.

Une fois l’instruction 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. Sinon, le GetInsertCommand utilise toujours les informations de l’instruction précédente, ce qui peut ne pas être correct. 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 paramètres basés sur les noms de colonnes à la DbCommandBuilder place.

GetInsertCommand()

Source:
DBCommandBuilder.cs
Source:
DBCommandBuilder.cs
Source:
DBCommandBuilder.cs

Obtient l'objet DbCommand généré automatiquement, qui est requis pour effectuer des insertions au niveau de la source de données.

public:
 System::Data::Common::DbCommand ^ GetInsertCommand();
public System.Data.Common.DbCommand GetInsertCommand ();
member this.GetInsertCommand : unit -> System.Data.Common.DbCommand
Public Function GetInsertCommand () As DbCommand

Retours

Objet DbCommand généré automatiquement, qui est requis 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 le définir explicitement sur le DbDataAdapter.

Une fois l’instruction 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. Sinon, le GetInsertCommand utilise toujours les informations de l’instruction précédente, ce qui peut ne pas être correct. Les instructions SQL sont d’abord générées lorsque l’application appelle Update ou GetInsertCommand.

Voir aussi

S’applique à

GetInsertCommand(Boolean)

Source:
DBCommandBuilder.cs
Source:
DBCommandBuilder.cs
Source:
DBCommandBuilder.cs

Obtient l'objet DbCommand généré automatiquement, qui est requis pour effectuer des insertions au niveau de la source de données, en utilisant éventuellement des 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.DbCommand
Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As DbCommand

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

Objet DbCommand généré automatiquement, qui est requis 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 le définir explicitement sur le DbDataAdapter.

Une fois l’instruction 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. Sinon, le GetInsertCommand utilise toujours les informations de l’instruction précédente, ce qui peut ne pas être correct. 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 pour le useColumnsForParameterNames paramètre vous permet de forcer le DbCommandBuilder à générer des paramètres basés sur les 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 :

Voir aussi

S’applique à