OleDbCommandBuilder.GetInsertCommand Metodo

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

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

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

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

Public Function GetInsertCommand () As OleDbCommand

Valori restituiti

Oggetto generato OleDbCommand automaticamente necessario per eseguire gli inserimenti.

Commenti

Un'applicazione può utilizzare il GetInsertCommand metodo per scopi informativi o di risoluzione dei problemi perché restituisce il testo dell'oggetto OleDbCommand da eseguire.

È anche possibile usare GetInsertCommand come base di un comando modificato. Ad esempio, è possibile chiamare GetInsertCommand e modificare il CommandTimeout valore e quindi impostarlo in modo esplicito su OleDbDataAdapter.

Dopo la prima generazione dell'istruzione SQL, l'applicazione deve chiamare RefreshSchema in modo esplicito se modifica l'istruzione in qualsiasi modo. In caso contrario, l'oggetto GetInsertCommand userà ancora le informazioni dell'istruzione precedente, che potrebbe non essere corretta. Le istruzioni SQL vengono generate per la prima volta quando l'applicazione chiama UpdateCommand o GetInsertCommand.

Vedi anche

• Generazione di comandi con CommandBuilders

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

Parametri

Valori restituiti

Oggetto generato OleDbCommand automaticamente necessario per eseguire gli inserimenti.

Commenti

Un'applicazione può utilizzare il GetInsertCommand metodo per scopi informativi o di risoluzione dei problemi perché restituisce il testo dell'oggetto OleDbCommand da eseguire.

È anche possibile usare GetInsertCommand come base di un comando modificato. Ad esempio, è possibile chiamare GetInsertCommand e modificare il CommandTimeout valore e quindi impostarlo in modo esplicito su OleDbDataAdapter.

Dopo la prima generazione dell'istruzione SQL, l'applicazione deve chiamare RefreshSchema in modo esplicito se modifica l'istruzione in qualsiasi modo. In caso contrario, l'oggetto GetInsertCommand userà ancora le informazioni dell'istruzione precedente, che potrebbe non essere corretta. Le istruzioni SQL vengono generate per la prima volta quando l'applicazione chiama UpdateCommand o GetInsertCommand.

Il comportamento predefinito, quando si generano nomi di parametri, consiste nell'usare @p1, @p2e così via per i vari parametri. Il passaggio true per il useColumnsForParameterNames parametro consente di forzare la OleDbCommandBuilder generazione di parametri in base ai nomi delle colonne. Questa operazione ha esito positivo solo se vengono soddisfatte le condizioni seguenti:

• È ParameterNameMaxLength stato specificato e la relativa lunghezza è uguale o maggiore del nome del parametro generato.

• Il nome del parametro generato soddisfa i criteri specificati nell'espressione ParameterNamePattern regolare.

• Viene specificato un ParameterMarkerFormat oggetto .

Vedi anche

• Generazione di comandi con CommandBuilders