DbCommandBuilder.GetInsertCommand Metodo

Definizione

Ottiene l'oggetto DbCommand generato automaticamente, richiesto per eseguire le operazioni di inserimento nell'origine dati.Gets the automatically generated DbCommand object required to perform insertions at the data source.

Overload

GetInsertCommand()

Ottiene l'oggetto DbCommand generato automaticamente, richiesto per eseguire le operazioni di inserimento nell'origine dati.Gets the automatically generated DbCommand object required to perform insertions at the data source.

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.Gets the automatically generated DbCommand object required to perform insertions at the data source, optionally using columns for parameter names.

Commenti

Un'applicazione può utilizzare il GetInsertCommand metodo a scopo informativo o di risoluzione dei problemi perché restituisce il testo DbCommand dell'oggetto da eseguire.An application can use the GetInsertCommand method for informational or troubleshooting purposes because it returns the text of the DbCommand object to be executed.

È anche possibile usare GetInsertCommand come base di un comando modificato.You can also use GetInsertCommand as the basis of a modified command. Ad esempio, è possibile chiamare GetInsertCommand e modificare il DbDataAdaptertesto del comando e quindi impostarlo in modo esplicito su.For example, you might call GetInsertCommand and modify command text, and then explicitly set that on the DbDataAdapter.

Dopo che l'istruzione SQL viene generata per la prima volta, l'applicazione RefreshSchema deve chiamare in modo esplicito se modifica l'istruzione in qualsiasi modo.After the SQL statement is first generated, the application must explicitly call RefreshSchema if it changes the statement in any way. In caso contrario GetInsertCommand , utilizzerà ancora le informazioni dell'istruzione precedente, che potrebbero non essere corrette.Otherwise, the GetInsertCommand will still be using information from the previous statement, which might not be correct. Le istruzioni SQL vengono innanzitutto generate quando l'applicazione chiama Update o GetInsertCommand.The SQL statements are first generated either when the application calls Update or GetInsertCommand.

Il comportamento predefinito, quando si generano i nomi dei parametri @p1, @p2consiste nell'usare, e così via per i vari parametri.The default behavior, when generating parameter names, is to use @p1, @p2, and so on for the various parameters. Se la versione di overload di GetInsertCommand consente di specificare questo comportamento, è possibile fare in modo che generi i DbCommandBuilder parametri in base ai nomi delle colonne.If the overloaded version of GetInsertCommand allows you to specify this behavior, you can cause the DbCommandBuilder to generate parameters based on the column names instead.

GetInsertCommand()

Ottiene l'oggetto DbCommand generato automaticamente, richiesto per eseguire le operazioni di inserimento nell'origine dati.Gets the automatically generated DbCommand object required to perform insertions at the data source.

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

Oggetto DbCommand generato automaticamente, richiesto per eseguire le operazioni di inserimento.The automatically generated DbCommand object required to perform insertions.

Commenti

Un'applicazione può utilizzare il GetInsertCommand metodo a scopo informativo o di risoluzione dei problemi perché restituisce il testo DbCommand dell'oggetto da eseguire.An application can use the GetInsertCommand method for informational or troubleshooting purposes because it returns the text of the DbCommand object to be executed.

È anche possibile usare GetInsertCommand come base di un comando modificato.You can also use GetInsertCommand as the basis of a modified command. Ad esempio, è possibile chiamare GetInsertCommand e modificare il testo del comando, quindi impostarlo DbDataAdapterin modo esplicito su.For example, you might call GetInsertCommand and modify the command text, and then explicitly set that on the DbDataAdapter.

Dopo che l'istruzione SQL viene generata per la prima volta, l'applicazione RefreshSchema deve chiamare in modo esplicito se modifica l'istruzione in qualsiasi modo.After the SQL statement is first generated, the application must explicitly call RefreshSchema if it changes the statement in any way. In caso contrario GetInsertCommand , utilizzerà ancora le informazioni dell'istruzione precedente, che potrebbero non essere corrette.Otherwise, the GetInsertCommand will still be using information from the previous statement, which might not be correct. Le istruzioni SQL vengono innanzitutto generate quando l'applicazione chiama Update o GetInsertCommand.The SQL statements are first generated either when the application calls Update or GetInsertCommand.

Vedi anche

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.Gets the automatically generated DbCommand object required to perform insertions at the data source, optionally using columns for parameter names.

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.If true, generate parameter names matching column names, if possible. Se false, genera @p1, @p2 e così via.If false, generate @p1, @p2, and so on.

Restituisce

Oggetto DbCommand generato automaticamente, richiesto per eseguire le operazioni di inserimento.The automatically generated DbCommand object required to perform insertions.

Commenti

Un'applicazione può utilizzare il GetInsertCommand metodo a scopo informativo o di risoluzione dei problemi perché restituisce il testo DbCommand dell'oggetto da eseguire.An application can use the GetInsertCommand method for informational or troubleshooting purposes because it returns the text of the DbCommand object to be executed.

È anche possibile usare GetInsertCommand come base di un comando modificato.You can also use GetInsertCommand as the basis of a modified command. Ad esempio, è possibile chiamare GetInsertCommand e modificare il testo del comando, quindi impostarlo DbDataAdapterin modo esplicito su.For example, you might call GetInsertCommand and modify the command text, and then explicitly set that on the DbDataAdapter.

Dopo che l'istruzione SQL viene generata per la prima volta, l'applicazione RefreshSchema deve chiamare in modo esplicito se modifica l'istruzione in qualsiasi modo.After the SQL statement is first generated, the application must explicitly call RefreshSchema if it changes the statement in any way. In caso contrario GetInsertCommand , utilizzerà ancora le informazioni dell'istruzione precedente, che potrebbero non essere corrette.Otherwise, the GetInsertCommand will still be using information from the previous statement, which might not be correct. Le istruzioni SQL vengono innanzitutto generate quando l'applicazione chiama Update o GetInsertCommand.The SQL statements are first generated either when the application calls Update or GetInsertCommand.

Il comportamento predefinito, quando si generano i nomi dei parametri @p1, @p2consiste nell'usare, e così via per i vari parametri.The default behavior, when generating parameter names, is to use @p1, @p2, and so on for the various parameters. Il true passaggio del useColumnsForParameterNames parametro consente di forzare la DbCommandBuilder generazione di parametri in base ai nomi di colonna.Passing true for the useColumnsForParameterNames parameter allows you to force the DbCommandBuilder to generate parameters based on the column names instead. La generazione dei parametri in base ai nomi di colonna ha esito positivo solo se vengono soddisfatte le condizioni seguenti:Generation of the parameters based on column names succeeds only if the following conditions are met:

Vedi anche

Si applica a