SqlCommandBuilder.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 SqlCommand généré automatiquement, qui est requis pour effectuer des insertions au niveau de la base de données.
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. |
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 .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. 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 Transact-SQL sont générées pour la première fois lorsque l’application appelle Update ou GetInsertCommand.
Pour plus d’informations, consultez Génération de commandes avec CommandBuilders.
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:
System::Data::SqlClient::SqlCommand ^ GetInsertCommand();
public System.Data.SqlClient.SqlCommand GetInsertCommand ();
override this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommand
member this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommand
Public Function GetInsertCommand () As SqlCommand
Retours
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 .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. 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 Transact-SQL sont générées pour la première fois 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
S’applique à
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:
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 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 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 .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. 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 Transact-SQL sont générées pour la première fois 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
, @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 :
Le ParameterNameMaxLength retourné par 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 de 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.
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