SqlCommand.EnableOptimizedParameterBinding Propriedade

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v5.2.0

Obtém ou define um valor que indica se o objeto de comando deve otimizar o desempenho do parâmetro desabilitando as instruções Output e InputOutput ao enviar o comando para o 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 da propriedade

Boolean

Um valor que indica se o objeto de comando deve otimizar o desempenho do parâmetro desabilitando as direções de parâmetro Output e InputOuput ao enviar o comando para o SQL Server. O padrão é false.

Comentários

Você deve definir o valor dessa propriedade antes que o comando seja executado para que ela entre em vigor.

Quando um comando é enviado ao servidor com parâmetros, uma lista de nomes de parâmetros é enviada como parte do envio. A lista é usada no servidor para corresponder os parâmetros Output e InputOutput aos resultados da execução da consulta para que os valores possam ser retornados ao chamador. Essa opção desabilita a construção e o envio da lista de nomes de parâmetro e, como consequência, desabilita o uso dos parâmetros Output e InputOutput. O parâmetro return não é afetado por essa opção.

Um comando enviado com essa opção altera a maneira como os parâmetros são tratados no servidor, pois não há necessidade de manter um mapa de parâmetros de saída. O resultado dessa alteração é que consultas com um grande número de parâmetros de entrada podem ser executadas muito mais rapidamente.

O menor número de parâmetros em que isso entrará em vigor depende da situação individual e deve ser detectado medindo a duração da consulta com e sem a opção habilitada. Qualquer consulta com mais de 24 parâmetros pode mostrar menor duração geral da consulta. É improvável que as consultas com contagens de parâmetros inferiores a 24 mostrem uma diferença.

Observação

Se a opção estiver habilitada e um parâmetro com Saída de Direção ou InputOutput estiver presente na coleção Parameters, um InvalidOperationException será gerado quando o comando for executado.