OdbcCommandBuilder.GetInsertCommand Méthode

public:
 System::Data::Odbc::OdbcCommand ^ GetInsertCommand();

public System.Data.Odbc.OdbcCommand GetInsertCommand();

member this.GetInsertCommand : unit -> System.Data.Odbc.OdbcCommand

override this.GetInsertCommand : unit -> System.Data.Odbc.OdbcCommand

Public Function GetInsertCommand () As OdbcCommand

Retours

Objet généré OdbcCommand automatiquement pour effectuer des insertions.

Remarques

Vous pouvez utiliser la GetInsertCommand méthode à des fins d’information ou de résolution des problèmes, car elle retourne l’objet OdbcCommand à 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 OdbcDataAdapter.

Une fois l’instruction SQL générée pour la première fois, vous devez appeler RefreshSchema explicitement s’il modifie l’instruction de quelque manière que ce soit. Sinon, l’utilisation GetInsertCommand des informations de l’instruction précédente sera toujours utilisée, ce qui peut ne pas être correct. Les instructions SQL sont d’abord générées lorsque l’application appelle ou UpdateGetInsertCommand.

Voir aussi

• Génération de commandes avec CommandBuilders

public:
 System::Data::Odbc::OdbcCommand ^ GetInsertCommand(bool useColumnsForParameterNames);

public System.Data.Odbc.OdbcCommand GetInsertCommand(bool useColumnsForParameterNames);

override this.GetInsertCommand : bool -> System.Data.Odbc.OdbcCommand

Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As OdbcCommand

Paramètres

Retours

Objet généré OdbcCommand automatiquement pour effectuer des insertions.

Remarques

Vous pouvez utiliser la GetInsertCommand méthode à des fins d’information ou de résolution des problèmes, car elle retourne l’objet OdbcCommand à 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 OdbcDataAdapter.

Une fois l’instruction SQL générée pour la première fois, vous devez appeler RefreshSchema explicitement s’il modifie l’instruction de quelque manière que ce soit. Sinon, l’utilisation GetInsertCommand des informations de l’instruction précédente risque de ne pas être correcte. Les instructions SQL sont d’abord générées lorsque l’application appelle ou UpdateGetInsertCommand.

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 DbCommandBuilder génération de paramètres en fonction des noms de colonnes à la place. Cela réussit uniquement si les conditions suivantes sont remplies :

• La ParameterNameMaxLength valeur a été spécifiée 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’expression ParameterNamePattern régulière.

• A ParameterMarkerFormat est spécifié.

Voir aussi

• Génération de commandes avec CommandBuilders