SQLBindParameter

SQLBindParameter может исключить нагрузку на преобразование данных при использовании для предоставления данных драйвера ODBC собственного клиента SQL Server, что приводит к значительному повышению производительности как для клиентских, так и для серверных компонентов приложений. Другие преимущества включают снижение точности при вставке или обновлении приблизительных числовых типов данных.

Замечание

При вставке и wchar вводе char данных в столбец изображения используется размер передаваемых данных, а не размер данных после преобразования в двоичный формат.

Если драйвер ODBC собственного клиента SQL Server обнаруживает ошибку в одном элементе массива параметров, драйвер продолжает выполнять инструкцию для оставшихся элементов массива. Если приложение привязывает массив элементов состояния параметра для инструкции, строки параметров, генерирующие ошибки, можно определить из массива.

При использовании драйвера ODBC собственного клиента SQL Server укажите SQL_PARAM_INPUT при привязке входных параметров. Укажите только SQL_PARAM_OUTPUT или SQL_PARAM_INPUT_OUTPUT при привязке параметров хранимой процедуры, определенных ключевым словом OUTPUT.

SQLRowCount является ненадежным с драйвером ODBC собственного клиента SQL Server, если элемент массива массива привязанных параметров вызывает ошибку в выполнении инструкции. Атрибут инструкции ODBC SQL_ATTR_PARAMS_PROCESSED_PTR сообщает количество строк, обработанных до возникновения ошибки. Затем приложение может пройти по массиву состояния параметров, чтобы обнаружить количество операторов, успешно выполненных при необходимости.

Параметры привязки для типов символов SQL

Если переданный тип данных SQL является символьным типом, ColumnSize — это размер символов (а не байтов). Если длина строки данных в байтах превышает 8000, значение ColumnSize должно быть задано SQL_SS_LENGTH_UNLIMITED, указывая, что размер типа SQL не ограничен.

Например, если тип данных SQL имеет значение SQL_WVARCHAR, ColumnSize не должно превышать 4000. Если фактическая длина данных превышает 4000, необходимо задать SQL_SS_LENGTH_UNLIMITEDзначение ColumnSize, чтобы nvarchar(max) использовать драйвер.

Параметры SQLBindParameter и Table-Valued

Как и другие типы параметров, табличное значение параметров привязаны к SQLBindParameter.

После привязки табличного параметра его столбцы также привязаны. Чтобы привязать столбцы, вызовите SQLSetStmtAttr , чтобы задать SQL_SOPT_SS_PARAM_FOCUS порядковый номер параметра с табличным значением. Затем вызовите SQLBindParameter для каждого столбца в параметре с табличным значением. Чтобы вернуться к привязкам параметров верхнего уровня, задайте значение SQL_SOPT_SS_PARAM_FOCUS значение 0.

Сведения о сопоставлении параметров с дескриптором для параметров с табличным значением см. в разделе Привязка и передача данных Table-Valued параметров и значений столбцов.

Дополнительные сведения о табличном значении параметров см. в разделе "Параметры с табличным значением" (ODBC).

Поддержка SQLBindParameter для расширенных функций даты и времени

Значения параметров типов даты и времени преобразуются, как описано в разделе "Преобразования из C в SQL". Обратите внимание, что параметры типа time и datetimeoffset должны иметь значение ValueType , как SQL_C_DEFAULT или SQL_C_BINARY если используются соответствующие структуры (SQL_SS_TIME2_STRUCT и SQL_SS_TIMESTAMPOFFSET_STRUCT) .

Дополнительные сведения см. в разделе "Улучшения даты и времени" (ODBC).

Поддержка SQLBindParameter для больших определяемых пользователем пользователей среды CLR

SQLBindParameter поддерживает большие определяемые пользователем типы СРЕДЫ CLR (определяемые пользователем UDT). Дополнительные сведения см. в разделе "Крупные определяемые пользователем типы CLR" (ODBC).

См. также

Подробные сведения о реализации API-интерфейсов ODBC
функция SQLBindParameter