SqlCommand.EnableOptimizedParameterBinding Proprietà
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 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, setPublic Property EnableOptimizedParameterBinding As BooleanValore della proprietà
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.