SqlCommand.EnableOptimizedParameterBinding プロパティ

定義

名前空間:

Microsoft.Data.SqlClient

アセンブリ:

Microsoft.Data.SqlClient.dll

パッケージ:

Microsoft.Data.SqlClient v5.2.0

コマンドをSQL Serverに送信するときに Output と InputOutput の方向を無効にして、コマンド オブジェクトがパラメーターのパフォーマンスを最適化する必要があるかどうかを示す値を取得または設定します。

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

プロパティ値

Boolean

コマンドをSQL Serverに送信するときに Output と InputOuput パラメーターの方向を無効にして、コマンド オブジェクトがパラメーターのパフォーマンスを最適化する必要があるかどうかを示す値。 既定値は、false です。

注釈

コマンドを実行して有効にするには、このプロパティの値を設定する必要があります。

パラメーターを指定してコマンドがサーバーに送信されると、パラメーター名の一覧が送信の一部として送信されます。 リストは、Output パラメーターと InputOutput パラメーターをクエリ実行の結果と照合して、値を呼び出し元に返すためにサーバー上で使用されます。 このオプションは、パラメーター名リストの構築と送信を無効にし、その結果、Output パラメーターと InputOutput パラメーターの使用を無効にします。 戻り値パラメーターは、このオプションの影響を受けません。

このオプションを指定して送信されたコマンドは、出力パラメーター マップを維持する必要がないため、サーバーでのパラメーターの処理方法を変更します。 この変更の結果、多数の入力パラメーターを含むクエリの実行速度が大幅に向上する可能性があります。

これが有効になるパラメーターの数が最も少ないのは個々の状況によって異なり、オプションが有効になっているかどうかに関係なくクエリ期間を測定して検出する必要があります。 パラメーターが 24 を超えるクエリでは、全体的なクエリ期間が低くなる可能性があります。 パラメーター数が 24 未満のクエリでは、違いが表示される可能性は低くなります。

注意

オプションが有効で、Direction Output または InputOutput のパラメーターが Parameters コレクションに存在する場合、コマンドの実行時に InvalidOperationException がスローされます。