DbCommandBuilder.GetInsertCommand Metodo

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

System.Data.Common.dll

Ottiene l'oggetto DbCommand generato automaticamente, richiesto per eseguire le operazioni di inserimento nell'origine dati.

Overload

GetInsertCommand()	Ottiene l'oggetto DbCommand generato automaticamente, richiesto per eseguire le operazioni di inserimento nell'origine dati.
GetInsertCommand(Boolean)	Ottiene l'oggetto DbCommand generato automaticamente, richiesto per eseguire le operazioni di inserimento nell'origine dati, eventualmente utilizzando le colonne per i nomi dei parametri.

Commenti

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

È anche possibile usare GetInsertCommand come base un comando modificato. Ad esempio, è possibile chiamare GetInsertCommand e modificare il testo del comando e quindi impostarlo in modo esplicito su DbDataAdapter.

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à comunque le informazioni dell'istruzione precedente, che potrebbe non essere corretta. Le istruzioni SQL vengono generate per prime quando l'applicazione chiama Update o GetInsertCommand.

Il comportamento predefinito, quando si generano nomi di parametro, consiste nell'usare @p1, @p2e così via per i vari parametri. Se la versione di overload di GetInsertCommand consente di specificare questo comportamento, è possibile generare DbCommandBuilder parametri in base ai nomi delle colonne.

GetInsertCommand()

Source:

DBCommandBuilder.cs

Ottiene l'oggetto DbCommand generato automaticamente, richiesto per eseguire le operazioni di inserimento nell'origine dati.

public:
 System::Data::Common::DbCommand ^ GetInsertCommand();

public System.Data.Common.DbCommand GetInsertCommand ();

member this.GetInsertCommand : unit -> System.Data.Common.DbCommand

Public Function GetInsertCommand () As DbCommand

Restituisce

DbCommand

Oggetto DbCommand generato automaticamente, richiesto per eseguire le operazioni di inserimento.

Commenti

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

È anche possibile usare GetInsertCommand come base un comando modificato. Ad esempio, è possibile chiamare GetInsertCommand e modificare il testo del comando e quindi impostarlo in modo esplicito su DbDataAdapter.

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à comunque le informazioni dell'istruzione precedente, che potrebbe non essere corretta. Le istruzioni SQL vengono generate per prime quando l'applicazione chiama Update o GetInsertCommand.

Vedi anche

• Generazione di comandi con CommandBuilders
• Panoramica di ADO.NET

GetInsertCommand(Boolean)

Source:

DBCommandBuilder.cs

Ottiene l'oggetto DbCommand generato automaticamente, richiesto per eseguire le operazioni di inserimento nell'origine dati, eventualmente utilizzando le colonne per i nomi dei parametri.

public:
 System::Data::Common::DbCommand ^ GetInsertCommand(bool useColumnsForParameterNames);

public System.Data.Common.DbCommand GetInsertCommand (bool useColumnsForParameterNames);

member this.GetInsertCommand : bool -> System.Data.Common.DbCommand

Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As DbCommand

Parametri

useColumnsForParameterNames

Boolean

Se true, genera i nomi dei parametri dai nomi delle colonne, se possibile. Se false, genera @p1, @p2 e così via.

Restituisce

DbCommand

Oggetto DbCommand generato automaticamente, richiesto per eseguire le operazioni di inserimento.

Commenti

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

È anche possibile usare GetInsertCommand come base un comando modificato. Ad esempio, è possibile chiamare GetInsertCommand e modificare il testo del comando e quindi impostarlo in modo esplicito su DbDataAdapter.

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à comunque le informazioni dell'istruzione precedente, che potrebbe non essere corretta. Le istruzioni SQL vengono generate per prime quando l'applicazione chiama Update o GetInsertCommand.

Il comportamento predefinito, quando si generano nomi di parametro, consiste nell'usare @p1, @p2e così via per i vari parametri. true Il passaggio per il useColumnsForParameterNames parametro consente di forzare la DbCommandBuilder generazione di parametri in base ai nomi di colonna. La generazione dei parametri in base ai nomi di colonna 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 oggetto ParameterMarkerFormat .

Vedi anche

• Generazione di comandi con CommandBuilders
• Panoramica di ADO.NET