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이 throw됩니다.