Поделиться через

  • Статья

Свойства и поведение наборов строк

Ниже приведены свойства наборов строк поставщика OLE DB для собственного клиента SQL Server.

Идентификатор свойства

Описание

DBPROP_ABORTPRESERVE

Чтение-запись: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: этим свойством определяется поведение набора строк после аварийного завершения операции.

VARIANT_FALSE: поставщик OLE DB для собственного клиента SQL Server делает наборы строк недействительными после аварийного завершения операции. Объект набора строк практически утратил свою функциональность. Он поддерживает только операции IUnknown, а также освобождение необработанных строк и обработчики методов доступа.

VARIANT_TRUE: Поставщик OLE DB для собственного клиента SQL Server содержит допустимый набор строк.

DBPROP_ACCESSORDER

Чтение-запись: чтение и запись

По умолчанию: DBPROPVAL_AO_RANDOM

Описание: порядок доступа. Порядок, в котором должен осуществляться доступ к столбцам в наборе строк.

DBPROPVAL_AO_RANDOM: доступ к столбцам можно осуществлять в любом порядке.

DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS: доступ к столбцам как к связанным объектам можно осуществлять только последовательно, по порядковому номеру столбца.

DBPROPVAL_AO_SEQUENTIAL: доступ ко всем столбцам должен осуществляться последовательно, по порядковому номеру столбца.

DBPROP_APPENDONLY

Поставщик OLE DB для собственного клиента SQL Server не реализует свойство набора строк. При попытке считать или записать значение свойства возникает ошибка.

DBPROP_BLOCKINGSTORAGEOBJECTS

Чтение-запись: только для чтения

По умолчанию: VARIANT_TRUE

Описание: объекты поставщика OLE DB для собственного клиента SQL Server блокируют использование других методов набора строк.

DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS

Чтение-запись: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: поставщик OLE DB для собственного клиента SQL Server поддерживает закладки для определения строки набора строк, если свойства DBPROP_BOOKMARKS или DBPROP_LITERALBOOKMARKS имеют значение VARIANT_TRUE.

Присвоение любому из этих свойств значения VARIANT_TRUE не включает позиционирование набора строк по закладке. Чтобы создать набор строк, поддерживающий позиционирование по закладке, присвойте свойству DBPROP_IRowsetLocate или DBPROP_IRowsetScroll значение VARIANT_TRUE.

Для поддержки наборов строк, содержащих закладки, поставщик OLE DB для собственного клиента SQL Server использует курсор MicrosoftSQL Server. Дополнительные сведения см. в разделе Наборы строк и курсоры SQL Server.

ПримечаниеПримечание
При указании для этих свойств таких значений, которые конфликтуют с другими свойствами поставщика OLE DB для собственного клиента SQL Server, определяющими курсоры, возникает ошибка. Например, при попытке потребителя открыть набор строк, свойства DBPROP_BOOKMARKS и DBPROP_OTHERINSERT которого имеют значение VARIANT_TRUE, будет выдана ошибка.

DBPROP_BOOKMARKSKIPPED

Чтение-запись: только чтение

По умолчанию: VARIANT_FALSE

Описание: поставщик OLE DB для собственного клиента SQL Server вернет значение DB_E_BADBOOKMARK, если потребитель указал недопустимую закладку при позиционировании или поиске набора строк с закладками.

DBPROP_BOOKMARKTYPE

Чтение-запись: только чтение

По умолчанию: DBPROPVAL_BMK_NUMERIC

Описание: поставщик OLE DB для собственного клиента SQL Server реализует только числовые закладки. Закладкой поставщика OLE DB для собственного клиента SQL Server является 32-разрядное целое число без знака, имеющее тип DBTYPE_UI4.

DBPROP_CACHEDEFERRED

Поставщик OLE DB для собственного клиента SQL Server не реализует свойство набора строк. При попытке считать или записать значение свойства возникает ошибка.

DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS

Чтение-запись: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: поставщик OLE DB для собственного клиента SQL Server поддерживает обратную выборку и прокрутку в непоследовательных наборах строк. Если свойства DBPROP_CANFETCHBACKWARDS и DBPROP_CANSCROLLBACKWARDS имеют значение VARIANT_TRUE, то поставщик OLE DB для собственного клиента SQL Server создает набор строк, поддерживаемый курсорами. Дополнительные сведения см. в разделе Наборы строк и курсоры SQL Server.

DBPROP_CANHOLDROWS

Чтение-запись: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: по умолчанию поставщик OLE DB для собственного клиента SQL Server возвращает значение DB_E_ROWSNOTRELEASED при попытке потребителя получить больше строк из набора, в котором существуют отложенные изменения. Это поведение может быть изменено.

Присвоение свойствам DBPROP_CANHOLDROWS и DBPROP_IRowsetChange значения VARIANT_TRUE подразумевает набор строк с закладками. Если оба свойства имеют значение VARIANT_TRUE, то для набора строк доступен интерфейс IRowsetLocate, а свойства DBPROP_BOOKMARKS и DBPROP_LITERALBOOKMARKS имеют значение VARIANT_TRUE.

Наборы строк поставщика OLE DB для собственного клиента SQL Server, содержащие закладки, поддерживаются курсорами SQL Server.

DBPROP_CHANGEINSERTEDROWS

Чтение-запись: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: это свойство может иметь только значение VARIANT_TRUE, если набор строк использует курсор, управляемый набором ключей.

DBPROP_COLUMNRESTRICT

Чтение-запись: только чтение

По умолчанию: VARIANT_FALSE

Описание: поставщик OLE DB для собственного клиента SQL Server присваивает этому свойству значение VARIANT_TRUE, если потребитель не может изменить столбец в наборе строк. Другие столбцы в наборе строк можно изменять, а сами строки — удалять.

Если это свойство имеет значение VARIANT_TRUE, то потребитель по элементу dwFlags структуры DBCOLUMNINFO определяет, может ли быть записано значение отдельного столбца. Для изменяемых столбцов элемент dwFlags принимает значение DBCOLUMNFLAGS_WRITE.

DBPROP_COMMANDTIMEOUT

Чтение-запись: чтение и запись

По умолчанию: 0

Описание: по умолчанию для поставщика OLE DB для собственного клиента SQL Server не проверяет истечение времени ожидания для метода ICommand::Execute.

DBPROP_COMMITPRESERVE

Чтение-запись: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: это свойство определяет поведение набора строк после выполнения фиксации.

VARIANT_TRUE: поставщик OLE DB для собственного клиента SQL Server содержит допустимый набор строк.

VARIANT_FALSE: поставщик OLE DB для собственного клиента SQL Server делает наборы строк недействительными после фиксации. Объект набора строк практически утратил свою функциональность. Он поддерживает только операции IUnknown, а также освобождение необработанных строк и обработчики методов доступа.

DBPROP_DEFERRED

Чтение-запись: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: при значении VARIANT_TRUE SQL Server поставщик OLE DB для собственного клиента пытается использовать серверный курсор для набора строк. Столбцы типа Text, ntext и image не возвращаются с сервера до тех пор, пока приложение обращается к ним.

DBPROP_DELAYSTORAGEOBJECTS

Чтение-запись: только чтение

По умолчанию: VARIANT_FALSE

Описание: поставщик OLE DB для собственного клиента 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_.

Описание: поставщик OLE DB для собственного клиента SQL Server поддерживает эти интерфейсы для всех наборов строк.

DBPROP_IColumnsRowset

Чтение-запись: чтение и запись

По умолчанию: VARIANT_TRUE

Описание: поставщик OLE DB для собственного клиента SQL Server поддерживает интерфейс IColumnsRowset.

DBPROP_IConnectionPointContainer

Чтение-запись: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: IConnectionPointContainer. Если значение равно VARIANT_TRUE, то набор строк поддерживает заданный интерфейс. Если значение равно VARIANT_FALSE, то набор строк не поддерживает заданный интерфейс. Поставщики, поддерживающие тот или иной интерфейс, должны поддерживать связанное с этим интерфейсом свойство, которое возвращает значение VARIANT_TRUE. Эти свойства служат главным образом для запроса интерфейсов с помощью метода ICommandProperties::SetProperties.

DBPROP_IMultipleResults

Чтение-запись: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: поставщик OLE DB для собственного клиента SQL Server поддерживает интерфейс IMultipleResults.

DBPROP_IRowsetChange DBPROP_IRowsetUpdate

Чтение-запись: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: поставщик OLE DB для собственного клиента SQL Server поддерживает интерфейсы IRowsetChange и IRowsetUpdate.

Набор строк, созданный с DBPROP_IRowsetChange, равным VARIANT_TRUE, отражает режимы немедленного обновления.

Если DBPROP_IRowsetUpdate имеет значение VARIANT_TRUE, то DBPROP_IRowsetChange также имеет значение VARIANT_TRUE. Набор строк характеризуется поведением отложенного обновления.

Поставщик OLE DB для собственного клиента SQL Server использует курсор SQL Server для поддержки набора строк с IRowsetChange или IRowsetUpdate. Дополнительные сведения см. в разделе Наборы строк и курсоры SQL Server.

DBPROP_IRowsetIdentity

Чтение-запись: чтение и запись

По умолчанию: VARIANT_TRUE

Описание: поставщик OLE DB собственного клиента SQL Server поддерживает интерфейс IRowsetIdentity. Если набор строк поддерживает этот интерфейс, то любые два дескриптора строк, относящихся к одной базовой строке, всегда представляют одни и те же данные и состояние. Потребители могут вызвать метод IRowsetIdentity:: IsSameRow, чтобы сравнить два дескриптора строки и проверить, относятся ли они к одному и тому же экземпляру строки.

DBPROP_IRowsetLocate DBPROP_IRowsetScroll

Чтение-запись: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: поставщик OLE DB для собственного клиента SQL Server поддерживает интерфейсы IRowsetLocate и IRowsetScroll.

Если DBPROP_IRowsetLocate имеет значение VARIANT_TRUE, то DBPROP_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 для собственного клиента SQL Server использует курсоры SQL Server для поддержки интерфейсов IRowsetLocate и IRowsetScroll. Дополнительные сведения см. в разделе Наборы строк и курсоры SQL Server.

При указании для этих свойств таких значений, которые конфликтуют с другими свойствами поставщика OLE DB для собственного клиента SQL Server, определяющими курсоры, возникает ошибка. Например, при попытке потребителя открыть набор строк, свойства DBPROP_IRowsetScroll и DBPROP_OTHERINSERT которого имеют значение VARIANT_TRUE, будет выдана ошибка.

DBPROP_IRowsetResynch

Чтение-запись: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: поставщик OLE DB для собственного клиента SQL Server поддерживает интерфейс IRowsetResynch по запросу. Поставщик OLE DB для собственного клиента SQL Server может поддерживать этот интерфейс в любом наборе строк.

DBPROP_ISupportErrorInfo

Чтение-запись: чтение и запись

По умолчанию: VARIANT_TRUE

Описание: поставщик OLE DB для собственного клиента SQL Server поддерживает интерфейс ISupportErrorInfo для набора строк.

DBPROP_ILockBytes

Поставщик OLE DB для собственного клиента SQL Server не реализует этот интерфейс. При попытке считать или записать свойство возникает ошибка.

DBPROP_ISequentialStream

Чтение-запись: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: поставщик OLE DB для собственного клиента SQL Server обеспечивает интерфейс ISequentialStream для поддержки больших данных переменной длины, хранящихся в SQL Server.

DBPROP_IStorage

Поставщик OLE DB для собственного клиента SQL Server не реализует этот интерфейс. При попытке считать или записать свойство возникает ошибка.

DBPROP_IStream

Поставщик OLE DB для собственного клиента 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 для собственного клиента SQL Server не ограничивает число активных наборов строк.

DBPROP_MAXPENDINGROWS

Чтение-запись: только для чтения

По умолчанию: 0

Описание: поставщик OLE DB для собственного клиента SQL Server не ограничивает число наборов строк с отложенными изменениями в наборе.

DBPROP_MAXROWS

Чтение-запись: чтение и запись

По умолчанию: 0

Описание: по умолчанию поставщик OLE DB для собственного клиента SQL Server не ограничивает число наборов строк в наборе. Если потребитель задал свойство DBPROP_MAXROWS, то поставщик OLE DB для собственного клиента SQL Server использует для ограничения числа строк в наборе инструкцию SET ROWCOUNT.

Это может привести к непредвиденным последствиям при выполнении инструкций в SQL Server. Дополнительные сведения см. в разделе SET ROWCOUNT.

DBPROP_MAYWRITECOLUMN

Поставщик OLE DB для собственного клиента SQL Server не реализует свойство набора строк. При попытке считать или записать значение свойства возникает ошибка.

DBPROP_MEMORYUSAGE

Поставщик OLE DB для собственного клиента SQL Server не реализует свойство набора строк. При попытке считать или записать значение свойства возникает ошибка.

DBPROP_NOTIFICATIONGRANULARITY

Поставщик OLE DB для собственного клиента SQL Server не реализует свойство набора строк. При попытке считать или записать значение свойства возникает ошибка.

DBPROP_NOTIFICATIONPHASES

Чтение-запись: только чтение

По умолчанию: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO | DBPROPVAL_NP_SYNCHAFTER | DBPROPVAL_NP_FAILEDTODO | DBPROPVAL_NP_DIDEVENT.

Описание: поставщик OLE DB для собственного клиента 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 для собственного клиента SQL Server могут быть отменены, прежде чем будет предпринята попытка выполнить указанное изменение набора строк. Поставщик OLE DB для собственного клиента SQL Server не поддерживает отмену этапа после завершения попытки.

DBPROP_ORDEREDBOOKMARKS

Поставщик OLE DB для собственного клиента SQL Server не реализует свойство набора строк. При попытке считать или записать значение свойства возникает ошибка.

DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE

Чтение-запись: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: установка свойств изменения видимости заставляет поставщика OLE DB для собственного клиента SQL Server использовать курсоры SQL Server для поддержки наборов строк. Дополнительные сведения см. в разделе Наборы строк и курсоры SQL Server.

DBPROP_QUICKRESTART

Чтение-запись: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: при значении VARIANT_TRUE SQL Server поставщик OLE DB для собственного клиента пытается использовать серверный курсор для набора строк.

DBPROP_REENTRANTEVENTS

Чтение-запись: только чтение

По умолчанию: VARIANT_TRUE

Описание: наборы строк поставщика OLE DB для собственного клиента SQL Server реентерабельны и могут возвратить значение DB_E_NOTREENTRANT, если потребитель пытается получить доступ к нереентерабельному методу набора строк из обратного вызова уведомления.

DBPROP_REMOVEDELETED

Чтение-запись: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: поставщик OLE DB для собственного клиента 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 для собственного клиента SQL Server не реализует свойство набора строк. При попытке считать или записать значение свойства возникает ошибка.

DBPROP_RETURNPENDINGINSERTS

Чтение-запись: только чтение

По умолчанию: VARIANT_FALSE

Описание: при вызове метода выборки строк поставщик OLE DB для собственного клиента SQL Server не возвращает строки, ожидающие вставки.

DBPROP_ROWRESTRICT

Чтение-запись: только чтение

По умолчанию: VARIANT_TRUE

Описание: наборы строк поставщика OLE DB для собственного клиента SQL Server не поддерживают права доступа на уровне строк. Если набор строк реализует интерфейс IRowsetChange, то потребитель может вызвать метод SetData.

DBPROP_ROWSET_ASYNCH

Чтение-запись: чтение и запись

По умолчанию: 0

Описание: обеспечивает асинхронную обработку набора строк. Это свойство относится к группе свойств наборов строк и набору свойств DBPROPSET_ROWSET и имеет тип VT_14.

Единственным значением в битовой маске, которое поддерживается собственным клиентом SQL Server, является DBPROPVAL_ASYNCH_INITIALIZE.

DBPROP_ROWTHREADMODEL

Чтение-запись: только для чтения

По умолчанию: DBPROPVAL_RT_FREETHREAD

Описание: поставщик OLE DB для собственного клиента 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 для собственного клиента SQL Server поддерживает только транзакционные объекты. Дополнительные сведения см. в разделе Транзакции.

DBPROP_UNIQUEROWS

Чтение-запись: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: уникальные строки.

VARIANT_TRUE: каждая строка определяется уникальными значениями столбца. Для набора столбцов, уникальным образом определяющих строку, в структуре DBCOLUMNINFO, возвращаемой методом GetColumnInfo.

VARIANT_FALSE: строки могут или не могут уникально определяться значениями своих столбцов. Ключевые столбцы могут быть либо помечены, либо не помечены флагом DBCOLUMNFLAGS_KEYCOLUMN.

DBPROP_UPDATABILITY

Чтение-запись: чтение и запись

По умолчанию: 0

Описание: поставщик OLE DB для собственного клиента SQL Server поддерживает все значения DBPROP_UPDATABILITY. Установка свойства DBPROP_UPDATABILITY не создает изменяемого набора строк. Чтобы сделать набор строк изменяемым, установите свойство DBPROP_IRowsetChange или DBPROP_IRowsetUpdate.

Поставщик OLE DB для собственного клиента SQL Server определяет зависящий от поставщика набор свойств DBPROPSET_SQLSERVERROWSET, как показано в следующей таблице.

Cвойство

Описание

SSPROP_COLUMN_ID

Столбец: ColumnID

Чтение-запись: только чтение

Тип: VT_U12 | VT_ARRAY

По умолчанию: VT_EMPTY

Описание: целочисленный массив значений, представляющих порядковые номера (начиная с 1) результирующего столбца предложения COMPUTE в текущей инструкции Transact-SQL SELECT. Это эквивалент атрибута ODBC SQL_CA_SS_COLUMN_ID поставщика OLE DB для собственного клиента SQL Server.

SSPROP_COMPUTE_BYLIST

Столбец: ComputeByList

Чтение-запись: только чтение

Тип: VT_BOOL

По умолчанию: VARIANT_FALSE

Описание: логическое значение, указывающее, что столбец входит в результирующий набор инструкции COMPUTE BY. Это эквивалент атрибута ODBC SQL_CA_SS_COMPUTE_BYLIST поставщика OLE DB для собственного клиента SQL Server.

ПримечаниеПримечание
Свойство OLE DB принадлежит к логическому типу, но атрибут ODBC представляет собой список значений типа unsigned short, представляющих порядковые номера столбцов, входящих в предложение BY.

VARIANT_TRUE: столбец поступил из инструкции COMPUTE BY.

VARIANT_FALSE: обычный столбец, поступил не из инструкции COMPUTE BY.

SSPROP_COMPUTE_ID

Столбец: ComputeID

Чтение-запись: только для чтения

Тип: VT_U12

По умолчанию: 0

Описание: идентификатор вычисления для строки, который является результатом предложения COMPUTE в текущей инструкции Transact-SQL SELECT. Это эквивалент атрибута ODBC SQL_CA_SS_COMPUTE_ID поставщика OLE DB для собственного клиента 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_MAXBLOBLENGTH

Столбец: нет

Чтение-запись: чтение и запись

Тип: VT_I4

По умолчанию: Поставщик не ограничивает размер текста, возвращаемого сервером, и это свойство определяет это максимальное значение. Например, 2147483647.

Описание: поставщик OLE DB для собственного клиента SQL Server для ограничения длины данных больших двоичных объектов (BLOB), возвращаемых инструкцией SELECT, выполняет инструкцию 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 до 2 000 символов).

По умолчанию: Пустая строка.

Описание: текст сообщения уведомления запроса. Определяется пользователем, не имеет формата определения.

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

По умолчанию: 432000 секунд (5 дней).

Не менее: 1 секунд.

не более: 2^31-1 секунд.

Описание: время в секундах, в течение которого уведомление запроса должно оставаться активным.

Журнал изменений

Обновленное содержимое

Обновлено описание для DBPROP_ROWSET_ASYNCH.

См. также

Основные понятия

Наборы строк