SqlCommand.EnableOptimizedParameterBinding Propiedad

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

Obtiene o establece un valor que indica si el objeto de comando debe optimizar el rendimiento de los parámetros deshabilitando las instrucciones Output y InputOutput al enviar el comando a la 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

Valor de propiedad

Boolean

Valor que indica si el objeto de comando debe optimizar el rendimiento de los parámetros deshabilitando las instrucciones del parámetro Output y InputOuput al enviar el comando a la SQL Server. El valor predeterminado es false.

Comentarios

Debe establecer el valor de esta propiedad antes de que se ejecute el comando para que surta efecto.

Cuando se envía un comando al servidor con parámetros, se envía una lista de los nombres de parámetro como parte del envío. La lista se usa en el servidor para que coincida con los parámetros Output y InputOutput con los resultados de la ejecución de la consulta para que los valores se puedan devolver al autor de la llamada. Esta opción deshabilita la construcción y el envío de la lista de nombres de parámetros y, como consecuencia, deshabilita el uso de parámetros Output y InputOutput. El parámetro return no se ve afectado por esta opción.

Un comando enviado con esta opción cambia la forma en que se controlan los parámetros en el servidor, ya que no es necesario mantener una asignación de parámetros de salida. El resultado de este cambio es que las consultas con un gran número de parámetros de entrada se pueden ejecutar mucho más rápido.

El menor número de parámetros en los que esto surte efecto depende de la situación individual y debe detectarse midiendo la duración de la consulta con y sin la opción habilitada. Cualquier consulta con más de 24 parámetros puede mostrar una duración de consulta general inferior. Es poco probable que las consultas con recuentos de parámetros inferiores a 24 muestren una diferencia.

Nota:

Si la opción está habilitada y un parámetro con Direction Output o InputOutput está presente en la colección Parameters, se producirá una excepción InvalidOperationException cuando se ejecute el comando.