Свойства и поведение наборов строк
Применимо к:
SQL Server Azure SQL DatabaseУправляемый экземпляр SQL AzureAzure Synapse Analytics AnalyticsPlatform System (PDW)
Ниже перечислены свойства набора строк OLE DB Driver for SQL Server.
| Идентификатор свойства | Описание |
|---|---|
| DBPROP_ABORTPRESERVE | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Этим свойством определяется поведение набора строк после аварийного завершения операции. VARIANT_FALSE: OLE DB Driver for SQL Server делает наборы строк недействительными после аварийного завершения операции. Объект набора строк практически утратил свою функциональность. Он поддерживает только операции IUnknown, а также освобождение необработанных строк и обработчики методов доступа. VARIANT_TRUE: OLE DB Driver for SQL Server поддерживает допустимый набор строк. |
| DBPROP_ACCESSORDER | Ч/З Чтение/запись Значение по умолчанию: DBPROPVAL_AO_RANDOM Описание. Порядок доступа. Порядок, в котором должен осуществляться доступ к столбцам в наборе строк. DBPROPVAL_AO_RANDOM: доступ к столбцам можно осуществлять в любом порядке. DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS: доступ к столбцам как к связанным объектам хранилища можно осуществлять только последовательно (по порядковому номеру столбца). DBPROPVAL_AO_SEQUENTIAL: доступ ко всем столбцам должен осуществляться последовательно (по порядковому номеру столбца). |
| DBPROP_APPENDONLY | OLE DB Driver for SQL Server не реализует это свойство наборов строк. При попытке считать или записать значение свойства возникает ошибка. |
| DBPROP_BLOCKINGSTORAGEOBJECTS | Ч/З Только для чтения Значение по умолчанию: VARIANT_TRUE Описание. Объекты хранилища OLE DB Driver for SQL Server блокируют использование других методов набора строк. |
| DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. OLE DB Driver for SQL Server поддерживает закладки для определения строки набора строк, если свойство DBPROP_BOOKMARKS или DBPROP_LITERALBOOKMARKS имеет значение VARIANT_TRUE. Присвоение любому из этих свойств значения VARIANT_TRUE не включает позиционирование набора строк по закладке. Чтобы создать набор строк, поддерживающий позиционирование по закладке, присвойте свойству DBPROP_IRowsetLocate или DBPROP_IRowsetScroll значение VARIANT_TRUE. OLE DB Driver for SQL Server использует курсор Microsoft SQL Server для поддержки набора строк, содержащего закладки. Дополнительные сведения см. в статье Наборы строк и курсоры SQL Server. Примечание. При указании для этих свойств таких значений, которые конфликтуют с другими свойствами драйвера OLE DB для SQL Server, определяющими курсоры, возникает ошибка. Например, при попытке потребителя открыть набор строк, свойства DBPROP_BOOKMARKS и DBPROP_OTHERINSERT которого имеют значение VARIANT_TRUE, будет выдана ошибка. |
| DBPROP_BOOKMARKSKIPPED | Ч/З Только для чтения Значение по умолчанию: VARIANT_FALSE Описание. OLE DB Driver for SQL Server вернет значение DB_E_BADBOOKMARK, если объект-получатель указал недопустимую закладку при позиционировании или поиске набора строк с закладками. |
| DBPROP_BOOKMARKTYPE | Ч/З Только для чтения Значение по умолчанию: DBPROPVAL_BMK_NUMERIC Описание. OLE DB Driver for SQL Server реализует только числовые закладки. Закладка OLE DB Driver for SQL Server — это 32-разрядное целое число без знака, имеющее тип DBTYPE_UI4. |
| DBPROP_CACHEDEFERRED | OLE DB Driver for SQL Server не реализует это свойство наборов строк. При попытке считать или записать значение свойства возникает ошибка. |
| DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. OLE DB Driver for SQL Server поддерживает обратную выборку и прокрутку в непоследовательных наборах строк. Если свойство DBPROP_CANFETCHBACKWARDS или DBPROP_CANSCROLLBACKWARDS имеет значение VARIANT_TRUE, то драйвер OLE DB для SQL Server создает набор строк, поддерживаемый курсорами. Дополнительные сведения см. в статье Наборы строк и курсоры SQL Server. |
| DBPROP_CANHOLDROWS | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание: По умолчанию OLE DB Driver for SQL Server возвращает значение DB_E_ROWSNOTRELEASED при попытке объекта-получателя получить больше строк для набора, в котором существуют ожидающие изменение. Это поведение может быть изменено. Присвоение свойствам DBPROP_CANHOLDROWS и DBPROP_IRowsetChange значения VARIANT_TRUE подразумевает набор строк с закладками. Если оба свойства имеют значение VARIANT_TRUE, то для набора строк доступен интерфейс IRowsetLocate, а свойства DBPROP_BOOKMARKS и DBPROP_LITERALBOOKMARKS имеют значение VARIANT_TRUE. Наборы строк OLE DB Driver for SQL Server, содержащие закладки, поддерживаются курсорами SQL Server. |
| DBPROP_CHANGEINSERTEDROWS | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Это свойство может иметь только значение VARIANT_TRUE, если набор строк использует курсор, управляемый набором ключей. |
| DBPROP_COLUMNRESTRICT | Ч/З Только для чтения Значение по умолчанию: VARIANT_FALSE Описание. OLE DB Driver for SQL Server задает для свойства значение VARIANT_TRUE, когда объект-получатель не может изменить столбец в наборе строк. Другие столбцы в наборе строк можно изменять, а сами строки — удалять. Если это свойство имеет значение VARIANT_TRUE, то потребитель по элементу dwFlags структуры DBCOLUMNINFO определяет, может ли быть записано значение отдельного столбца. Для изменяемых столбцов элемент dwFlags принимает значение DBCOLUMNFLAGS_WRITE. |
| DBPROP_COMMANDTIMEOUT | Ч/З Чтение/запись Значение по умолчанию: 0 Описание. По умолчанию OLE DB Driver for SQL Server не проверяет истечение времени ожидания для метода ICommand::Execute. |
| DBPROP_COMMITPRESERVE | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Это свойство определяет поведение набора строк после выполнения фиксации. VARIANT_TRUE: OLE DB Driver for SQL Server поддерживает допустимый набор строк. VARIANT_FALSE: OLE DB Driver for SQL Server делает наборы строк недействительными после выполнения фиксации. Объект набора строк практически утратил свою функциональность. Он поддерживает только операции IUnknown, а также освобождение необработанных строк и обработчики методов доступа. |
| DBPROP_DEFERRED | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Если задано значение VARIANT_TRUE, OLE DB Driver for SQL Server пытается использовать серверный курсор для набора строк. Столбцы типа text, ntext и image не возвращаются с сервера до тех пор, пока приложение не обратится к ним. |
| DBPROP_DELAYSTORAGEOBJECTS | Ч/З Только для чтения Значение по умолчанию: VARIANT_FALSE Описание. OLE DB Driver for SQL Server поддерживает режим немедленного обновления в объектах хранилища. Изменения, примененные к данным в объекте последовательного потока, немедленно передаются SQL Server. Фиксация изменений производится в соответствии с режимом транзакций набора строк. |
| DBPROP_HIDDENCOLUMNS | Ч/З Только для чтения Значение по умолчанию: VARIANT_FALSE Описание. Число скрытых столбцов. Если DBPROP_UNIQUEROWS имеет значение VARIANT_TRUE, то свойство DBPROP_HIDDENCOLUMNS возвращает число дополнительных «скрытых» столбцов, добавленных поставщиком для уникальной идентификации строк в наборе. Эти столбцы возвращаются методами IColumnsInfo::GetColumnInfo и IColumnsRowset::GetColumnsRowset. Однако они не включаются в число строк, которое возвращается в аргументе pcColumns метода IColumnsInfo::GetColumnInfo. Чтобы выяснить общее число столбцов, представленных в структуре prgInfo, которую возвращает метод IColumnsInfo::GetColumnInfo (включая скрытые), потребитель должен добавить значение свойства DBPROP_HIDDENCOLUMNS к числу столбцов, возвращаемых методом IColumnsInfo::GetColumnInfo в pcColumns. Если свойство DBPROP_UNIQUEROWS имеет значение VARIANT_FALSE, то свойство DBPROP_HIDDENCOLUMNS равно нулю. |
| DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo | Ч/З Только для чтения Значение по умолчанию: VARIANT_TRUE Описание. OLE DB Driver for SQL Server поддерживает эти интерфейсы для всех наборов строк. |
| DBPROP_IColumnsRowset | Ч/З Чтение/запись Значение по умолчанию: VARIANT_TRUE Описание. OLE DB Driver for SQL Server поддерживает интерфейс IColumnsRowset. |
| DBPROP_IConnectionPointContainer | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. IConnectionPointContainer. Если значение равно VARIANT_TRUE, то набор строк поддерживает заданный интерфейс. Если значение равно VARIANT_FALSE, то набор строк не поддерживает заданный интерфейс. Поставщики, поддерживающие тот или иной интерфейс, должны поддерживать связанное с этим интерфейсом свойство, которое возвращает значение VARIANT_TRUE. Эти свойства служат главным образом для запроса интерфейсов с помощью метода ICommandProperties::SetProperties. |
| DBPROP_IMultipleResults | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. OLE DB Driver for SQL Server поддерживает интерфейс IMultipleResults. |
| DBPROP_IRowsetChange DBPROP_IRowsetUpdate | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. OLE DB Driver for SQL Server поддерживает интерфейсы IRowsetChange и IRowsetUpdate. Набор строк, созданный с DBPROP_IRowsetChange, равным VARIANT_TRUE, отражает режимы немедленного обновления. Если DBPROP_IRowsetUpdate имеет значение VARIANT_TRUE, то DBPROP_IRowsetChange также имеет значение VARIANT_TRUE. Набор строк характеризуется поведением отложенного обновления. OLE DB Driver for SQL Server использует курсор SQL Server для поддержки наборов строк с IRowsetChange или IRowsetUpdate. Дополнительные сведения см. в статье Наборы строк и курсоры SQL Server. |
| DBPROP_IRowsetIdentity | Ч/З Чтение/запись Значение по умолчанию: VARIANT_TRUE Описание. OLE DB Driver for SQL Server поддерживает интерфейс IRowsetIdentity. Если набор строк поддерживает этот интерфейс, то любые два дескриптора строк, относящихся к одной базовой строке, всегда представляют одни и те же данные и состояние. Объекты-получатели могут вызвать метод IRowsetIdentity:: IsSameRow, чтобы сравнить два дескриптора строки и проверить, относятся ли они к одному и тому же экземпляру строки. |
| DBPROP_IRowsetLocate DBPROP_IRowsetScroll | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. OLE DB Driver for SQL Server поддерживает интерфейсы IRowsetLocate и IRowsetScroll. Если DBPROP_IRowsetLocate имеет значение VARIANT_TRUE, CANFETCHBACKWARDS и DBPROP_CANSCROLLBACKWARDS также имеют значение VARIANT_TRUE. Если DBPROP_IRowsetScroll имеет значение VARIANT_TRUE, то DBPROP_IRowsetLocate также имеет значение VARIANT_TRUE, поэтому оба интерфейса доступны в наборе строк. Закладки необходимы для обоих интерфейсов. Драйвер OLE DB для SQL Server присваивает свойствам DBPROP_BOOKMARKS и DBPROP_LITERALBOOKMARKS значение VARIANT_TRUE, если потребитель запрашивает один из этих интерфейсов. OLE DB Driver for SQL Server использует курсоры SQL Server для поддержки IRowsetLocate и IRowsetScroll. Дополнительные сведения см. в статье Наборы строк и курсоры SQL Server. При указании для этих свойств таких значений, которые конфликтуют с другими свойствами драйвера OLE DB для SQL Server, определяющими курсоры, возникает ошибка. Например, при попытке потребителя открыть набор строк, свойства DBPROP_IRowsetScroll и DBPROP_OTHERINSERT которого имеют значение VARIANT_TRUE, будет выдана ошибка. |
| DBPROP_IRowsetResynch | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. OLE DB Driver for SQL Server поддерживает интерфейс IRowsetResynch по запросу. OLE DB Driver for SQL Server может поддерживать интерфейс для любого набора строк. |
| DBPROP_ISupportErrorInfo | Ч/З Чтение/запись Значение по умолчанию: VARIANT_TRUE Описание. OLE DB Driver for SQL Server поддерживает интерфейс ISupportErrorInfo для наборов строк. |
| DBPROP_ILockBytes | OLE DB Driver for SQL Server не реализует этот интерфейс. При попытке считать или записать свойство возникает ошибка. |
| DBPROP_ISequentialStream | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. OLE DB Driver for SQL Server поддерживает интерфейс ISequentialStream для поддержки данных типа Long переменной длины, хранящихся в SQL Server. |
| DBPROP_IStorage | OLE DB Driver for SQL Server не реализует этот интерфейс. При попытке считать или записать свойство возникает ошибка. |
| DBPROP_IStream | OLE DB Driver for SQL Server не реализует этот интерфейс. При попытке считать или записать свойство возникает ошибка. |
| DBPROP_IMMOBILEROWS | Ч/З Чтение/запись Значение по умолчанию: VARIANT_TRUE Описание. Это свойство имеет значение VARIANT_TRUE только для тех курсоров, которые управляются набором ключей SQL Server. Для всех остальных курсоров оно имеет значение VARIANT_FALSE. VARIANT_TRUE: набор строк не будет переупорядочивать вставленные или обновленные строки. Для метода IRowsetChange::InsertRow строки появляются в конце набора. Если набор строк не упорядочен, то метод IRowsetChange::SetData не меняет положение обновленных строк. Если набор строк упорядочен, то при изменении методом IRowsetChange::SetData столбца, который использовался для упорядочивания набора строк, строка не перемещается. Если набор строк построен на наборе ключевых столбцов (обычно это столбцы, свойство DBPROP_OTHERUPDATEDELETE которых имеет значение VARIANT_TRUE, а свойство DBPROP_OTHERINSERT — значение VARIANT_FALSE), то изменение значения ключевого столбца, как правило, эквивалентно удалению текущей строки вставке новой. Поэтому строка может переместиться или даже исчезнуть из набора строк, если свойство DBPROP_OWNINSERT имеет значение VARIANT_FALSE, даже со значением свойства DBPROP_IMMOBILEROWS, равным VARIANT_TRUE. VARIANT_FALSE: если набор строк упорядочен, то вставленные строки находятся в правильном порядке набора строк. Если набор строк не является упорядоченным, то вставленные строки появляются в конце. Если метод IRowsetChange::SetData изменяет столбец, который использовался для упорядочивания набора строк, то строка будет перемещена. Если набор строк не упорядочен, то положение строки не меняется. |
| DBPROP_LITERALIDENTITY | Ч/З Только для чтения Значение по умолчанию: VARIANT_TRUE Описание. Значение этого свойства всегда равно VARIANT_TRUE. |
| DBPROP_LOCKMODE | Ч/З Чтение/запись Значение по умолчанию: DBPROPVAL_LM_NONE Описание. Уровень блокировки, выполняемый набором строк (DBPROPVAL_LM_NONE, DBPROPVAL_LM_SINGLEROW). Примечание. Если при использовании в транзакции изоляции моментальных снимков набор строк открывается при использовании набора ключей или динамического серверного курсора, а режим блокировки установлен в DBPROPVAL_LM_SINGLEROW, то произойдет ошибка при выборке строки, если кто-то другой обновил эту строку с момента начала транзакции. Для других типов курсоров и режимов блокировки, если другой пользователь обновил строку со времени начала транзакции, то ошибка не произойдет до тех пор, пока пользователь не попытается обновить эту строку. В обоих случаях ошибка будет сформирована сервером. |
| DBPROP_MAXOPENROWS | Ч/З Только для чтения Значение по умолчанию: 0 Описание. OLE DB Driver for SQL Server не ограничивает число строк, которые могут быть активными в наборах строк. |
| DBPROP_MAXPENDINGROWS | Ч/З Только для чтения Значение по умолчанию: 0 Описание. OLE DB Driver for SQL Server не ограничивает число строк с отложенными изменениями в наборе строк. |
| DBPROP_MAXROWS | Ч/З Чтение/запись Значение по умолчанию: 0 Описание. По умолчанию OLE DB Driver for SQL Server не ограничивает количество строк в наборе строк. Если потребитель задал свойство DBPROP_MAXROWS, то драйвер OLE DB для SQL Server использует инструкцию SET ROWCOUNT для ограничения числа строк в наборе. Это может привести к непредвиденным последствиям при выполнении инструкций в SQL Server. Дополнительные сведения см. в разделе SET ROWCOUNT. |
| DBPROP_MAYWRITECOLUMN | OLE DB Driver for SQL Server не реализует это свойство наборов строк. При попытке считать или записать значение свойства возникает ошибка. |
| DBPROP_MEMORYUSAGE | OLE DB Driver for SQL Server не реализует это свойство наборов строк. При попытке считать или записать значение свойства возникает ошибка. |
| DBPROP_NOTIFICATIONGRANULARITY | OLE DB Driver for SQL Server не реализует это свойство наборов строк. При попытке считать или записать значение свойства возникает ошибка. |
| DBPROP_NOTIFICATIONPHASES | Ч/З Только для чтения По умолчанию: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO | DBPROPVAL_NP_SYNCHAFTER | DBPROPVAL_NP_FAILEDTODO | DBPROPVAL_NP_DIDEVENT Описание. OLE DB Driver for SQL Server поддерживает все этапы уведомления. |
| DBPROP_NOTIFYCOLUMNSET DBPROP_NOTIFYROWDELETE DBPROP_NOTIFYROWFIRSTCHANGE DBPROP_NOTIFYROWINSERT DBPROP_NOTIFYROWRESYNCH DBPROP_NOTIFYROWSETRELEASE DBPROP_NOTIFYROWSETFETCH-POSITIONCHANGE DBPROP_NOTIFYROWUNDOCHANGE DBPROP_NOTIFYROWUNDODELETE DBPROP_NOTIFYROWUNDOINSERT DBPROP_NOTIFYROWUPDATE | Ч/З Только для чтения По умолчанию: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO Описание. Этапы уведомлений OLE DB Driver for SQL Server могут быть отменены, прежде чем будет предпринята попытка выполнить указанное изменение набора строк. OLE DB Driver for SQL Server не поддерживает отмену этапа после завершения попытки. |
| DBPROP_ORDEREDBOOKMARKS | OLE DB Driver for SQL Server не реализует это свойство наборов строк. При попытке считать или записать значение свойства возникает ошибка. |
| DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Установка свойств изменения видимости заставляет OLE DB Driver for SQL Server использовать курсоры SQL Server для поддержки наборов строк. Дополнительные сведения см. в статье Наборы строк и курсоры SQL Server. |
| DBPROP_QUICKRESTART | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Если задано значение VARIANT_TRUE, OLE DB Driver for SQL Server пытается использовать серверный курсор для набора строк. |
| DBPROP_REENTRANTEVENTS | Ч/З Только для чтения Значение по умолчанию: VARIANT_TRUE Описание. Наборы строк OLE DB Driver for SQL Server реентерабельны и могут возвратить значение DB_E_NOTREENTRANT, если объект-получатель пытается получить доступ к нереентерабельному методу набора строк из обратного вызова уведомления. |
| DBPROP_REMOVEDELETED | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. OLE DB Driver for SQL Server изменяет значение свойства на основе видимости изменений данных SQL Server, доступных из набора строк. VARIANT_TRUE: строки, удаленные объектом-получателем или другими пользователями SQL Server, удаляются из набора строк при его обновлении. Значение DBPROP_OTHERINSERT равно VARIANT_TRUE. VARIANT_FALSE: строки, удаленные объектом-получателем или другими пользователями SQL Server, не удаляются из набора строк при его обновлении. Значением состояния удаленных строк SQL Server в наборе строк является DBROWSTATUS_E_DELETED. Значение DBPROP_OTHERINSERT равно VARIANT_TRUE. Это свойство имеет значение только для наборов строк, поддерживаемых курсорами SQL Server. Дополнительные сведения см. в статье Наборы строк и курсоры SQL Server. Если в наборе строк курсора, управляемого набором ключей, реализовано свойство DBPROP_REMOVEDELETED, то удаленные строки удаляются во время выборки, поэтому методы выборки строк, например GetNextRows и GetRowsAt, могут вернуть как значение S_OK, так и число строк меньше запрошенного. Это не означает, что выполняется условие DB_S_ENDOFROWSET, а также что количество строк никогда не будет равным нулю, если имеются оставшиеся строки. |
| DBPROP_REPORTMULTIPLECHANGES | OLE DB Driver for SQL Server не реализует это свойство наборов строк. При попытке считать или записать значение свойства возникает ошибка. |
| DBPROP_RETURNPENDINGINSERTS | Ч/З Только для чтения Значение по умолчанию: VARIANT_FALSE Описание. При вызове метода выборки строк OLE DB Driver for SQL Server не возвращает строки, ожидающие вставки. |
| DBPROP_ROWRESTRICT | Ч/З Только для чтения Значение по умолчанию: VARIANT_TRUE Описание. Наборы строк OLE DB Driver for SQL Server не поддерживают права доступа на уровне строк. Если набор строк реализует интерфейс IRowsetChange, то потребитель может вызвать метод SetData. |
| DBPROP_ROWSET_ASYNCH | Ч/З Чтение/запись Значение по умолчанию: 0 Описание. Обеспечивает асинхронную обработку набора строк. Это свойство относится к группе свойств наборов строк и набору свойств DBPROPSET_ROWSET. и имеет тип VT_14. Единственным значением в битовой маске, которое поддерживается OLE DB Driver for SQL Server, является DBPROPVAL_ASYNCH_INITIALIZE. |
| DBPROP_ROWTHREADMODEL | Ч/З Только для чтения Значение по умолчанию: DBPROPVAL_RT_FREETHREAD Описание. OLE DB Driver for SQL Server поддерживает доступ к своим объектам из нескольких потоков выполнения одного объекта-получателя. |
| DBPROP_SERVERCURSOR | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Если установлено, то для поддержки набора строк используется курсор SQL Server. Дополнительные сведения см. в статье Наборы строк и курсоры SQL Server. |
| DBPROP_SERVERDATAONINSERT | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Данные сервера при вставке. VARIANT_TRUE: при передаче операции вставки на сервер поставщик получает данные с сервера для обновления локального кэша строк. VARIANT_FALSE: поставщик не получает с сервера значения для только что вставленных строк. |
| DBPROP_STRONGIDENTITY | Ч/З Только для чтения Значение по умолчанию: VARIANT_TRUE Описание. Строгий идентификатор строки. Если набор строк допускает операции вставки (IRowsetChange или IRowsetUpdate имеют значение true), а свойство DBPROP_UPDATABILITY установлено для поддержки InsertRows, то значение DBPROP_STRONGIDENTITY зависит от свойства DBPROP_CHANGEINSERTEDROWS (VARIANT_FALSE, если свойство DBPROP_CHANGEINSERTEDROWS имеет значение VARIANT_FALSE). |
| DBPROP_TRANSACTEDOBJECT | Ч/З Только для чтения Значение по умолчанию: VARIANT_FALSE Описание. OLE DB Driver for SQL Server поддерживает только транзакционные объекты. Дополнительные сведения см. в статье о транзакциях. |
| DBPROP_UNIQUEROWS | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Уникальные строки. VARIANT_TRUE: каждая строка определяется уникальными значениями столбца. Для набора столбцов, уникальным образом определяющих строку, в структуре DBCOLUMNINFO, возвращаемой методом GetColumnInfo, установлен флаг DBCOLUMNFLAGS_KEYCOLUMN. VARIANT_FALSE: строки могут или не могут уникально определяться значениями своих столбцов. Ключевые столбцы могут быть либо помечены, либо не помечены флагом DBCOLUMNFLAGS_KEYCOLUMN. |
| DBPROP_UPDATABILITY | Ч/З Чтение/запись Значение по умолчанию: 0 Описание. OLE DB Driver for SQL Server поддерживает все значения DBPROP_UPDATABILITY. Установка свойства DBPROP_UPDATABILITY не создает изменяемого набора строк. Чтобы сделать набор строк изменяемым, установите свойство DBPROP_IRowsetChange или DBPROP_IRowsetUpdate. |
Драйвер OLE DB для SQL Server определяет зависящий от поставщика набор свойств DBPROPSET_SQLSERVERROWSET, как показано в таблице ниже.
| Идентификатор свойства | Описание |
|---|---|
| SSPROP_COLUMN_ID | Столбец: ColumnID Ч/З Только для чтения Тип: VT_U12 | VT_ARRAY Значение по умолчанию: VT_EMPTY Описание. Целочисленный массив значений, представляющих порядковые номера (начиная с 1) результирующего столбца предложения COMPUTE в текущей инструкции Transact-SQL SELECT. Это эквивалент атрибута ODBC SQL_CA_SS_COLUMN_ID для OLE DB Driver for SQL Server. |
| SSPROP_DEFERPREPARE | Столбец: нет Ч/З Чтение/запись Тип: VT_BOOL. Значение по умолчанию: VARIANT_TRUE Описание. VARIANT_TRUE: при выполнении с подготовкой команда подготовки откладывается до вызова метода ICommand::Execute или выполнения операции метасвойства. Если свойство имеет значение VARIANT_FALSE: подготовка инструкции производится при вызове метода ICommandPrepare::Prepare. |
| SSPROP_IRowsetFastLoad | Столбец: нет Ч/З Чтение/запись Тип: VT_BOOL. Значение по умолчанию: VARIANT_FALSE Описание. Чтобы открыть набор строк быстрой загрузки с помощью метода IOpenRowset::OpenRowset, присвойте этому свойству значение VARIANT_TRUE. Это свойство не может быть установлено в методе ICommandProperties::SetProperties. |
| SSPROP_ISSAsynchStatus | Столбец: Нет. Ч/З Чтение/запись Тип: VT_BOOL. Значение по умолчанию: VARIANT_FALSE Описание. Чтобы задействовать асинхронные операции через интерфейс ISSAsynchStatus, присвойте этому свойству значение VARIANT_TRUE. |
| SSPROP_ISSDataClassification | Ч/З Чтение/запись Тип: VT_BOOL. Значение по умолчанию: VARIANT_TRUE Описание: OLE DB Driver for SQL Server поддерживает получение сведений о классификации конфиденциальных данных с помощью интерфейса ISSDataClassification. |
| SSPROP_MAXBLOBLENGTH | Столбец: нет Ч/З Чтение/запись Тип: VT_I4 Значение по умолчанию: поставщик не ограничивает размер текста, возвращаемого сервером, и это свойство определяет это максимальное значение. Например, 2147483647. Описание. Для ограничения длины данных больших двоичных объектов (BLOB), возвращаемых инструкцией SELECT, OLE DB Driver for SQL Server выполняет инструкцию SET TEXTSIZE. |
| SSPROP_NOCOUNT_STATUS | Столбец: NoCount. Ч/З Только для чтения Тип: VT_BOOL. Значение по умолчанию: VARIANT_FALSE Описание. Логическое значение, представляющее состояние SET NOCOUNT ON/OFF в SQL Server: VARIANT_TRUE: если SET NOCOUNT ON VARIANT_FALSE: если SET NOCOUNT OFF |
| SSPROP_QP_NOTIFICATION_MSGTEXT | Столбец: нет Ч/З Чтение/запись Тип: VT_BSTR (допустимо от 1 до 2000 символов). Значение по умолчанию: Пустая строка. Описание. Текст сообщения уведомления запроса. Определяется пользователем, не имеет формата определения. |
| SSPROP_QP_NOTIFICATION_OPTIONS | Столбец: нет Ч/З Чтение/запись Тип: VT_BSTR Значение по умолчанию: Пустая строка. Описание. параметры уведомлений о запросах. Указывается в строке name=value. За создание службы и считывание уведомлений из очереди отвечает пользователь. Строка параметров уведомлений запросов имеет следующий синтаксис.service=<service-name>[;(local database=<database>|broker instance=<broker instance>)]Пример: service=mySSBService;local database=mydb |
| SSPROP_QP_NOTIFICATION_TIMEOUT | Столбец: нет Ч/З Чтение/запись Тип: VT_UI4 Значение по умолчанию: 432 000 секунд (5 дней). Минимальные: 1 секунда. Максимальное значение: 2^31–1 секунд. Описание. время в секундах, в течение которого уведомление запроса должно оставаться активным. |
См. также:
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по