SqlCommandBuilder.GetUpdateCommand Metodo

Definizione

Spazio dei nomi:

System.Data.SqlClient

Assembly:

System.Data.SqlClient.dll

Pacchetto:

System.Data.SqlClient v4.8.6

Ottiene l'oggetto SqlCommand generato automaticamente, richiesto per eseguire le operazioni di aggiornamento nel database.

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.

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 di un comando modificato. Ad esempio, è possibile chiamare GetUpdateCommand e modificare il CommandTimeout valore e quindi impostare in modo esplicito tale valore su SqlDataAdapter.

Dopo la 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 prima generate quando l'applicazione chiama Update o GetUpdateCommand.

Per altre informazioni, vedere Generazione dei comandi con CommandBuilders.

GetUpdateCommand()

Ottiene l'oggetto SqlCommand generato automaticamente, richiesto per eseguire le operazioni di aggiornamento nel database.

public:
 System::Data::SqlClient::SqlCommand ^ GetUpdateCommand();

public System.Data.SqlClient.SqlCommand GetUpdateCommand ();

override this.GetUpdateCommand : unit -> System.Data.SqlClient.SqlCommand

Public Function GetUpdateCommand () As SqlCommand

Restituisce

SqlCommand

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 di un comando modificato. Ad esempio, è possibile chiamare GetUpdateCommand e modificare il CommandTimeout valore e quindi impostare in modo esplicito tale valore su SqlDataAdapter.

Dopo la 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 prima generate quando l'applicazione chiama Update o GetUpdateCommand.

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

GetUpdateCommand(Boolean)

Ottiene l'oggetto SqlCommand generato automaticamente, richiesto per eseguire le operazioni di aggiornamento nel database.

public:
 System::Data::SqlClient::SqlCommand ^ GetUpdateCommand(bool useColumnsForParameterNames);

public System.Data.SqlClient.SqlCommand GetUpdateCommand (bool useColumnsForParameterNames);

override this.GetUpdateCommand : bool -> System.Data.SqlClient.SqlCommand

Public Function GetUpdateCommand (useColumnsForParameterNames As Boolean) As SqlCommand

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

SqlCommand

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 di un comando modificato. Ad esempio, è possibile chiamare GetUpdateCommand e modificare il CommandTimeout valore e quindi impostare in modo esplicito tale valore su SqlDataAdapter.

Dopo la 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 prima generate quando l'applicazione chiama Update o GetUpdateCommand.

Il comportamento predefinito, quando si generano nomi di parametri, consiste nell'usare @p1, @p2e così via per i vari parametri. Il passaggio per il useColumnsForParameterNames parametro consente di forzare true la OleDbCommandBuilder generazione di parametri in base ai nomi di colonna. Questa operazione ha esito positivo solo se vengono soddisfatte le condizioni seguenti:

• Il 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 nella ParameterNamePattern chiamata al metodo GetSchema e trovato nell'espressione regolare della DataSourceInformation raccolta.

• Viene specificato un ParameterMarkerFormat oggetto restituito dalla chiamata al metodo GetSchema e trovato nella DataSourceInformation raccolta.

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