SqlCommandBuilder.GetUpdateCommand 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.
Overload
| GetUpdateCommand() |
Ottiene l'oggetto SqlCommand generato automaticamente, richiesto per eseguire le operazioni di aggiornamento nel database. |
| GetUpdateCommand(Boolean) |
Ottiene l'oggetto SqlCommand generato automaticamente, richiesto per eseguire le operazioni di aggiornamento nel database. |
GetUpdateCommand()
Ottiene l'oggetto SqlCommand generato automaticamente, richiesto per eseguire le operazioni di aggiornamento nel database.
public:
Microsoft::Data::SqlClient::SqlCommand ^ GetUpdateCommand();public Microsoft.Data.SqlClient.SqlCommand GetUpdateCommand ();member this.GetUpdateCommand : unit -> Microsoft.Data.SqlClient.SqlCommandoverride this.GetUpdateCommand : unit -> Microsoft.Data.SqlClient.SqlCommandPublic Function GetUpdateCommand () As SqlCommandRestituisce
Oggetto SqlCommand generato automaticamente richiesto per eseguire le operazioni di aggiornamento.
Commenti
Un'applicazione può usare il GetUpdateCommand metodo per scopi informativi o di risoluzione dei problemi perché restituisce l'oggetto SqlCommand da eseguire.
È anche possibile usare GetUpdateCommand come base un comando modificato. Ad esempio, è possibile chiamare GetUpdateCommand 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 RefreshSchema in modo esplicito se modifica l'istruzione in qualsiasi modo. In caso contrario, l'oggetto GetUpdateCommand 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 GetUpdateCommand.
Per altre informazioni, vedere Generazione dei comandi con CommandBuilders.
Si applica a
GetUpdateCommand(Boolean)
Ottiene l'oggetto SqlCommand generato automaticamente, richiesto per eseguire le operazioni di aggiornamento nel database.
public:
Microsoft::Data::SqlClient::SqlCommand ^ GetUpdateCommand(bool useColumnsForParameterNames);public Microsoft.Data.SqlClient.SqlCommand GetUpdateCommand (bool useColumnsForParameterNames);member this.GetUpdateCommand : bool -> Microsoft.Data.SqlClient.SqlCommandoverride this.GetUpdateCommand : bool -> Microsoft.Data.SqlClient.SqlCommandPublic Function GetUpdateCommand (useColumnsForParameterNames As Boolean) As SqlCommandParametri
- useColumnsForParameterNames
- Boolean
Se true, genera i nomi dei parametri dai nomi delle colonne, se possibile. Se false, genera @p1, @p2 e così via.
Restituisce
L'oggetto SqlCommand generato automaticamente richiesto per eseguire le operazioni di aggiornamento.
Commenti
Un'applicazione può usare il GetUpdateCommand metodo per scopi informativi o di risoluzione dei problemi perché restituisce l'oggetto SqlCommand da eseguire.
È anche possibile usare GetUpdateCommand come base un comando modificato. Ad esempio, è possibile chiamare GetUpdateCommand 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 RefreshSchema in modo esplicito se modifica l'istruzione in qualsiasi modo. In caso contrario, l'oggetto GetUpdateCommand 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 GetUpdateCommand.
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 invece a OleDbCommandBuilder generare parametri in base ai nomi di colonna. L'operazione ha esito positivo solo se vengono soddisfatte le condizioni seguenti:
L'oggetto ParameterNameMaxLength restituito dalla chiamata al metodo GetSchema e trovato nella DataSourceInformation raccolta è stato specificato e la 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.