SqlCommandBuilder.GetInsertCommand Méthode

Définition

Espace de noms:

System.Data.SqlClient

Assembly:

System.Data.dll

Obtient l’objet généré SqlCommand automatiquement requis pour effectuer des insertions sur la base de données.

Surcharges

Nom	Description
GetInsertCommand()	Obtient l’objet généré SqlCommand automatiquement requis pour effectuer des insertions sur la base de données.
GetInsertCommand(Boolean)	Obtient l’objet généré SqlCommand automatiquement requis pour effectuer des insertions sur la base 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 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 définir explicitement cette valeur sur le SqlDataAdapter.

Une fois l’instruction Transact-SQL générée pour la première fois, l’application doit appeler explicitement RefreshSchema si elle 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 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()

Obtient l’objet généré SqlCommand automatiquement requis pour effectuer des insertions sur la base de données.

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

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

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

Public Function GetInsertCommand () As SqlCommand

Retours

SqlCommand

Objet généré SqlCommand 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 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 définir explicitement cette valeur sur le SqlDataAdapter.

Une fois l’instruction Transact-SQL générée pour la première fois, l’application doit appeler explicitement RefreshSchema si elle 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 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.

Voir aussi

• Connexion et récupération de données dans ADO.NET
• Utilisation du fournisseur de données .NET Framework pour SQL Server
• Vue d'ensemble d’ADO.NET

GetInsertCommand(Boolean)

Obtient l’objet généré SqlCommand automatiquement requis pour effectuer des insertions sur la base de données.

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

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

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

Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As SqlCommand

Paramè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

SqlCommand

Objet généré SqlCommand automatiquement 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 définir explicitement cette valeur sur le SqlDataAdapter.

Une fois l’instruction Transact-SQL générée pour la première fois, l’application doit appeler explicitement RefreshSchema si elle 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 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 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 :

• Retourné ParameterNameMaxLength à 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 du paramètre généré.

• Le nom du paramètre généré répond aux critères spécifiés dans l’appel ParameterNamePattern de méthode GetSchema et trouvé dans l’expression régulière de la DataSourceInformation collection.

• Un ParameterMarkerFormat retour 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.

Voir aussi

• Connexion et récupération de données dans ADO.NET
• Utilisation du fournisseur de données .NET Framework pour SQL Server
• Vue d'ensemble d’ADO.NET