DbCommandBuilder.GetInsertCommand Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene l'oggetto generato DbCommand automaticamente necessario per eseguire inserimenti nell'origine dati.
Overload
| Nome | Descrizione |
|---|---|
| GetInsertCommand() |
Ottiene l'oggetto generato DbCommand automaticamente necessario per eseguire inserimenti nell'origine dati. |
| GetInsertCommand(Boolean) |
Ottiene l'oggetto generato DbCommand automaticamente necessario per eseguire inserimenti nell'origine dati, facoltativamente utilizzando colonne per i nomi dei parametri. |
Commenti
Un'applicazione può utilizzare 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 di 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 la prima volta quando l'applicazione chiama Update o GetInsertCommand.
Il comportamento predefinito, quando si generano nomi di parametri, consiste nell'usare @p1, @p2e così via per i vari parametri. Se la versione di overload di consente di GetInsertCommand specificare questo comportamento, è possibile che generi DbCommandBuilder parametri in base ai nomi delle colonne.
GetInsertCommand()
Ottiene l'oggetto generato DbCommand automaticamente necessario per eseguire inserimenti nell'origine dati.
public:
System::Data::Common::DbCommand ^ GetInsertCommand();public System.Data.Common.DbCommand GetInsertCommand();member this.GetInsertCommand : unit -> System.Data.Common.DbCommandPublic Function GetInsertCommand () As DbCommandValori restituiti
Oggetto generato DbCommand 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 DbCommand da eseguire.
È anche possibile usare GetInsertCommand come base di 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 la prima volta quando l'applicazione chiama Update o GetInsertCommand.
Vedi anche
Si applica a
GetInsertCommand(Boolean)
Ottiene l'oggetto generato DbCommand automaticamente necessario per eseguire inserimenti nell'origine dati, facoltativamente utilizzando 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.DbCommandPublic Function GetInsertCommand (useColumnsForParameterNames As Boolean) As DbCommandParametri
- useColumnsForParameterNames
- Boolean
Se true, generare nomi di parametri corrispondenti ai nomi di colonna, se possibile. Se false, generare @p1, @p2e così via.
Valori restituiti
Oggetto generato DbCommand 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 DbCommand da eseguire.
È anche possibile usare GetInsertCommand come base di 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 la prima volta quando l'applicazione chiama Update 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 DbCommandBuilder generazione di parametri in base ai nomi delle colonne. 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 ParameterMarkerFormat oggetto .