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。