SqlCommand.EnableOptimizedParameterBinding Свойство

Определение

Пространство имен:

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

Возвращает или задает значение, указывающее, должен ли объект команды оптимизировать производительность параметров путем отключения направлений Output и InputOutput при отправке команды в 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

Значение свойства

Boolean

Значение, указывающее, должен ли объект команды оптимизировать производительность параметров, отключив направления параметров Output и InputOuput при отправке команды в SQL Server. Значение по умолчанию — false.

Комментарии

Для этого свойства необходимо задать значение перед выполнением команды, чтобы оно вошло в силу.

При отправке на сервер команды с параметрами в составе отправки отправляется список имен параметров. Список используется на сервере для сопоставления параметров Output и InputOutput с результатами выполнения запроса, что позволяет возвращать значения вызывающей стороне. Этот параметр отключает создание и отправку списка имен параметров и, как следствие, отключает использование параметров Output и InputOutput. Этот параметр не влияет на возвращаемый параметр.

Команда, отправленная с этим параметром, изменяет способ обработки параметров на сервере, так как нет необходимости поддерживать сопоставление выходных параметров. Результатом этого изменения является то, что запросы с большим количеством входных параметров могут выполняться гораздо быстрее.

Наименьшее количество параметров, в которых это войдет в силу, зависит от конкретной ситуации и должно быть обнаружено путем измерения длительности запроса с включенным параметром и без него. Любой запрос с более чем 24 параметрами может показать меньшую общую длительность запроса. Запросы с числом параметров ниже 24 вряд ли будут отображать разницу.

Примечание

Если параметр включен и параметр с выходными данными направления или InputOutput присутствует в коллекции Parameters, при выполнении команды будет выдано исключение InvalidOperationException.