SqlCommandBuilder.GetInsertCommand Méthode

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Surcharges

GetInsertCommand()	Obtient l'objet SqlCommand généré automatiquement, qui est requis pour effectuer des suppressions au niveau de la base de données.
GetInsertCommand(Boolean)	Obtient l'objet SqlCommand généré automatiquement, qui est requis pour effectuer des insertions au niveau de la base de données.

GetInsertCommand()

Obtient l'objet SqlCommand généré automatiquement, qui est requis pour effectuer des suppressions au niveau de la base de données.

public:
 Microsoft::Data::SqlClient::SqlCommand ^ GetInsertCommand();

public Microsoft.Data.SqlClient.SqlCommand GetInsertCommand ();

override this.GetInsertCommand : unit -> Microsoft.Data.SqlClient.SqlCommand

Public Function GetInsertCommand () As SqlCommand

Retours

SqlCommand

Objet SqlCommand 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 l’objet SqlCommand à 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 le SqlDataAdapter.

Une fois l’instruction Transact-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 Transact-SQL sont d’abord générées lorsque l’application appelle Update ou GetInsertCommand.

Pour plus d’informations, consultez Génération de commandes avec CommandBuilders.

GetInsertCommand(Boolean)

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

public:
 Microsoft::Data::SqlClient::SqlCommand ^ GetInsertCommand(bool useColumnsForParameterNames);

public Microsoft.Data.SqlClient.SqlCommand GetInsertCommand (bool useColumnsForParameterNames);

override this.GetInsertCommand : bool -> Microsoft.Data.SqlClient.SqlCommand

Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As SqlCommand

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

SqlCommand

Objet SqlCommand 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 l’objet SqlCommand à 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 le SqlDataAdapter.

Une fois l’instruction Transact-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 Transact-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 OleDbCommandBuilder à générer des paramètres basés sur les noms de colonnes à la place. Cette opération réussit uniquement si les conditions suivantes sont remplies :

• Le ParameterNameMaxLength retourné à partir de l’appel de méthode GetSchema et trouvé dans la DataSourceInformation collection a é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 le ParameterNamePattern retourné à partir de l’appel de méthode GetSchema et trouvé dans l’expression régulière de la DataSourceInformation collection.

• Un ParameterMarkerFormat retourné à partir de l’appel de méthode GetSchema et trouvé dans la DataSourceInformation collection est spécifié.

Pour plus d’informations, consultez Génération de commandes avec CommandBuilders.