SqlCommandBuilder.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 SqlCommand automaticamente necessario per eseguire inserimenti nel database.
Overload
| Nome | Descrizione |
|---|---|
| GetInsertCommand() |
Ottiene l'oggetto generato SqlCommand automaticamente necessario per eseguire inserimenti nel database. |
| GetInsertCommand(Boolean) |
Ottiene l'oggetto generato SqlCommand automaticamente necessario per eseguire inserimenti nel database. |
Commenti
Un'applicazione può usare il GetInsertCommand metodo per scopi informativi o di risoluzione dei problemi perché restituisce l'oggetto SqlCommand 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 SqlDataAdapter.
Dopo la prima generazione dell'istruzione Transact-SQL, l'applicazione deve chiamare in modo esplicito RefreshSchema 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 Transact-SQL vengono generate per la prima volta quando l'applicazione chiama Update o GetInsertCommand.
Per altre informazioni, vedere Generazione dei comandi con CommandBuilders.
GetInsertCommand()
Ottiene l'oggetto generato SqlCommand automaticamente necessario per eseguire inserimenti nel database.
public:
System::Data::SqlClient::SqlCommand ^ GetInsertCommand();public System.Data.SqlClient.SqlCommand GetInsertCommand();member this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommandoverride this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommandPublic Function GetInsertCommand () As SqlCommandValori restituiti
Oggetto generato SqlCommand automaticamente necessario per eseguire gli inserimenti.
Commenti
Un'applicazione può usare il GetInsertCommand metodo per scopi informativi o di risoluzione dei problemi perché restituisce l'oggetto SqlCommand 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 SqlDataAdapter.
Dopo la prima generazione dell'istruzione Transact-SQL, l'applicazione deve chiamare in modo esplicito RefreshSchema 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 Transact-SQL vengono generate per la prima volta quando l'applicazione chiama Update o GetInsertCommand.
Per altre informazioni, vedere Generazione dei comandi con CommandBuilders.
Vedi anche
- Connessione e recupero di dati in ADO.NET
- Uso del provider di dati .NET Framework per SQL Server
- Panoramica di ADO.NET
Si applica a
GetInsertCommand(Boolean)
Ottiene l'oggetto generato SqlCommand automaticamente necessario per eseguire inserimenti nel database.
public:
System::Data::SqlClient::SqlCommand ^ GetInsertCommand(bool useColumnsForParameterNames);public System.Data.SqlClient.SqlCommand GetInsertCommand(bool useColumnsForParameterNames);override this.GetInsertCommand : bool -> System.Data.SqlClient.SqlCommandPublic Function GetInsertCommand (useColumnsForParameterNames As Boolean) As SqlCommandParametri
- 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 SqlCommand automaticamente necessario per eseguire gli inserimenti.
Commenti
Un'applicazione può usare il GetInsertCommand metodo per scopi informativi o di risoluzione dei problemi perché restituisce l'oggetto SqlCommand 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 SqlDataAdapter.
Dopo la prima generazione dell'istruzione Transact-SQL, l'applicazione deve chiamare in modo esplicito RefreshSchema 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 Transact-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 OleDbCommandBuilder generazione di parametri in base ai nomi delle colonne. Questa operazione ha esito positivo solo se vengono soddisfatte le condizioni seguenti:
L'oggetto ParameterNameMaxLength restituito dalla chiamata al metodo GetSchema e trovato nella raccolta è stato specificato e la DataSourceInformation relativa lunghezza è uguale o maggiore del nome del parametro generato.
Il nome del parametro generato soddisfa i criteri specificati nell'oggetto ParameterNamePattern restituito dalla chiamata al metodo GetSchema e trovato nell'espressione regolare della DataSourceInformation raccolta.
Oggetto ParameterMarkerFormat restituito dalla chiamata al metodo GetSchema e trovato nella DataSourceInformation raccolta è specificato.
Per altre informazioni, vedere Generazione dei comandi con CommandBuilders.
Vedi anche
- Connessione e recupero di dati in ADO.NET
- Uso del provider di dati .NET Framework per SQL Server
- Panoramica di ADO.NET