SqlCommand.EnableOptimizedParameterBinding Proprietà

Definizione

Spazio dei nomi:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacchetto:

Microsoft.Data.SqlClient v5.2.0

Ottiene o imposta un valore che indica se l'oggetto comando deve ottimizzare le prestazioni dei parametri disabilitando le istruzioni di Output e InputOutput durante l'invio del comando al SQL Server.

public:
 property bool EnableOptimizedParameterBinding { bool get(); void set(bool value); };

public bool EnableOptimizedParameterBinding { get; set; }

member this.EnableOptimizedParameterBinding : bool with get, set

Public Property EnableOptimizedParameterBinding As Boolean

Valore della proprietà

Boolean

Valore che indica se l'oggetto comando deve ottimizzare le prestazioni dei parametri disabilitando le istruzioni dei parametri Output e InputOuput durante l'invio del comando al SQL Server. Il valore predefinito è false.

Commenti

Per rendere effettivo il comando, è necessario impostare il valore per questa proprietà.

Quando un comando viene inviato al server con parametri, viene inviato un elenco dei nomi dei parametri come parte dell'invio. L'elenco viene utilizzato nel server per associare i parametri Output e InputOutput ai risultati dell'esecuzione della query in modo che i valori possano essere restituiti al chiamante. Questa opzione disabilita la costruzione e l'invio dell'elenco dei nomi dei parametri e, di conseguenza, disabilita l'uso dei parametri Output e InputOutput. Il parametro restituito non è interessato da questa opzione.

Un comando inviato con questa opzione modifica la modalità di gestione dei parametri nel server, perché non è necessario mantenere una mappa dei parametri di output. Il risultato di questa modifica è che le query con un numero elevato di parametri di input possono essere eseguite molto più velocemente.

Il minor numero di parametri in cui avrà effetto dipende dalla singola situazione e deve essere rilevato misurando la durata della query con e senza l'opzione abilitata. Qualsiasi query con più di 24 parametri può mostrare una durata complessiva della query inferiore. È improbabile che le query con conteggi dei parametri inferiori a 24 mostrino una differenza.

Nota

Se l'opzione è abilitata e un parametro con Direction Output o InputOutput è presente nell'insieme Parameters, verrà generata un'eccezione InvalidOperationException quando viene eseguito il comando.