SqlCommand.EnableOptimizedParameterBinding Eigenschaft

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Ruft einen Wert ab, der angibt, ob das Befehlsobjekt die Parameterleistung optimieren soll, indem die Anweisungen Output und InputOutput deaktiviert werden, wenn der Befehl an den SQL Server übermittelt wird, oder legt diesen fest.

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

Eigenschaftswert

Boolean

Ein Wert, der angibt, ob das Befehlsobjekt die Parameterleistung optimieren soll, indem die Parameteranweisungen Output und InputOuput deaktiviert werden, wenn der Befehl an den SQL Server übermittelt wird. Der Standardwert lautet false.

Hinweise

Sie müssen den Wert für diese Eigenschaft festlegen, bevor der Befehl ausgeführt wird, damit er wirksam wird.

Wenn ein Befehl mit Parametern an den Server übermittelt wird, wird eine Liste der Parameternamen als Teil der Übermittlung gesendet. Die Liste wird auf dem Server verwendet, um die Parameter Output und InputOutput mit den Ergebnissen der Abfrageausführung abzugleichen, damit die Werte an den Aufrufer zurückgegeben werden können. Diese Option deaktiviert die Erstellung und Übermittlung der Parameternamenliste und deaktiviert folglich die Verwendung der Parameter Output und InputOutput. Der Rückgabeparameter ist von dieser Option nicht betroffen.

Ein Befehl, der mit dieser Option gesendet wird, ändert die Art und Weise, wie Parameter auf dem Server behandelt werden, da keine Ausgabeparameterzuordnung verwaltet werden muss. Das Ergebnis dieser Änderung ist, dass Abfragen mit einer großen Anzahl von Eingabeparametern viel schneller ausgeführt werden können.

Die geringste Anzahl von Parametern, in denen dies wirksam wird, hängt von der jeweiligen Situation ab und sollte durch Messen der Abfragedauer mit und ohne aktivierte Option erkannt werden. Jede Abfrage mit mehr als 24 Parametern kann eine niedrigere Gesamtdauer der Abfrage aufweisen. Es ist unwahrscheinlich, dass Abfragen mit einer Parameteranzahl von weniger als 24 einen Unterschied aufweisen.

Hinweis

Wenn die Option aktiviert ist und ein Parameter mit Direction Output oder InputOutput in der Parameters-Auflistung vorhanden ist, wird beim Ausführen des Befehls eine InvalidOperationException ausgelöst.