SqlCommand.EnableOptimizedParameterBinding Vlastnost

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

Získá nebo nastaví hodnotu označující, zda příkaz objektu by měl optimalizovat výkon parametru zakázání Output a InputOutput směry při odeslání příkazu do 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

Hodnota vlastnosti

Boolean

Hodnota označující, jestli má objekt příkazu optimalizovat výkon parametru zakázáním pokynů parametru Output a InputOuput při odesílání příkazu do SQL Server. Výchozí formát je false.

Poznámky

Před provedením příkazu je nutné nastavit hodnotu této vlastnosti, aby se projevila.

Při odeslání příkazu na server s parametry se v rámci odeslání odešle seznam názvů parametrů. Seznam se používá na serveru ke spárování parametrů Output a InputOutput s výsledky provádění dotazu, aby bylo možné hodnoty vrátit volajícímu. Tato možnost zakáže vytvoření a odeslání seznamu názvů parametrů a v důsledku toho zakáže použití parametrů Output a InputOutput. Návratový parametr není touto možností ovlivněn.

Příkaz odeslaný s touto možností změní způsob zpracování parametrů na serveru, protože není potřeba udržovat mapování výstupních parametrů. Výsledkem této změny je, že dotazy s velkým počtem vstupních parametrů se můžou spouštět mnohem rychleji.

Nejmenší počet parametrů, u kterých se to projeví, závisí na konkrétní situaci a mělo by se zjistit měřením doby trvání dotazu s povolenou možností a bez této možnosti. Jakýkoli dotaz s více než 24 parametry může zobrazit kratší celkovou dobu trvání dotazu. Dotazy s počtem parametrů nižším než 24 pravděpodobně nezobrazí rozdíl.

Poznámka

Pokud je možnost povolena a parametr se Direction Output nebo InputOutput je k dispozici v kolekci Parameters, invalidOperationException bude vyvolána při spuštění příkazu.