OleDbCommandBuilder.GetInsertCommand Méthode

Définition

Espace de noms:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Paquet:

System.Data.OleDb v8.0.0

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

Surcharges

GetInsertCommand()	Obtient l'objet OleDbCommand généré automatiquement, qui est requis pour effectuer des insertions au niveau de la source de données.
GetInsertCommand(Boolean)	Obtient l'objet OleDbCommand généré automatiquement, qui est requis pour effectuer des insertions au niveau de 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 la définir explicitement sur .OleDbDataAdapter

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. Dans le cas contraire, le GetInsertCommand utilise toujours les informations de l’instruction précédente, ce qui peut ne pas être correct. Les instructions SQL sont générées pour la première fois lorsque l’application appelle UpdateCommand ou GetInsertCommand.

GetInsertCommand()

Source:

OleDbCommandBuilder.cs

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

public:
 System::Data::OleDb::OleDbCommand ^ GetInsertCommand();

public System.Data.OleDb.OleDbCommand GetInsertCommand ();

override this.GetInsertCommand : unit -> System.Data.OleDb.OleDbCommand

Public Function GetInsertCommand () As OleDbCommand

Retours

OleDbCommand

Objet OleDbCommand 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 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 la définir explicitement sur .OleDbDataAdapter

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. Dans le cas contraire, le GetInsertCommand utilise toujours les informations de l’instruction précédente, ce qui peut ne pas être correct. Les instructions SQL sont générées pour la première fois lorsque l’application appelle UpdateCommand ou GetInsertCommand.

Voir aussi

• Génération de commandes avec CommandBuilders

GetInsertCommand(Boolean)

Source:

OleDbCommandBuilder.cs

Obtient l'objet OleDbCommand généré automatiquement, qui est requis pour effectuer des insertions au niveau de 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.OleDbCommand

Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As OleDbCommand

Paramètres

useColumnsForParameterNames

Boolean

Si la valeur est true, générer des noms de paramètres correspondant aux noms des colonnes, dans la mesure du possible. Si la valeur est false, génère @p1, @p2, etc.

Retours

OleDbCommand

Objet OleDbCommand 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 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 la définir explicitement sur .OleDbDataAdapter

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. Dans le cas contraire, le GetInsertCommand utilise toujours les informations de l’instruction précédente, ce qui peut ne pas être correct. Les instructions SQL sont générées pour la première fois lorsque l’application appelle UpdateCommand ou GetInsertCommand.

Le comportement par défaut, lors de la génération de noms de paramètres, consiste à utiliser @p1, @p2, et ainsi de suite pour les différents paramètres. Passer true pour le useColumnsForParameterNames paramètre vous permet de forcer le OleDbCommandBuilder à générer des paramètres en fonction des noms de colonnes à la place. Cette opération réussit uniquement si les conditions suivantes sont remplies :

• a ParameterNameMaxLength été spécifié et sa longueur est égale ou supérieure au nom de 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.

• Un ParameterMarkerFormat est spécifié.

Voir aussi

• Génération de commandes avec CommandBuilders