Свойства набора строк (OLE DB)

Набор свойств DBPROPSET_ROWSET включает в себя следующие свойства. Все эти свойства входят в группу свойств набора строк. Дополнительные свойства определены в DBPROPSET_SSCE_ROWSET.

Свойство

Описание

DBPROP_ABORTPRESERVE

  • Тип: VT_BOOL

  • Стандартная операция чтения-записи: только для чтения

  • Описание: сохранять при аварийном завершении

  • Примечание. Для данного поставщика значение всегда равно VARIANT_FALSE. Это означает, что после прекращения транзакции в наборе строк разрешены только операции освобождения строки и дескрипторов методов доступа, а также освобождения набора строк

DBPROP_ACCESSORDER

  • Тип: VT_I4

  • Операция чтения-записи: только для чтения

  • Описание: порядок доступа

  • Примечание. Для данного поставщика значение всегда равно DBPROPVAL_AO_RANDOM.

DBPROP_BLOCKINGSTORAGEOBJECTS

  • Тип: VT_BOOL

  • Стандартная операция чтения-записи: только для чтения

  • Описание: блокировка объектов хранилища

  • Примечание. Для данного поставщика значение всегда равно VARIANT_TRUE.

DBPROP_BOOKMARKS

  • Тип: VT_BOOL

  • Стандартная операция чтения-записи: чтение и запись

  • Описание: использование закладок

  • Примечание. Указывает, поддерживает ли набор строк закладки. Поставщик поддерживает следующие значения:

    • VARIANT_TRUE, которое означает, что набор строк поддерживает закладки. Столбец «0» — это закладка для строк. Запрос этого столбца возвращает значение закладки. С его помощью можно переместить строку;

    • VARIANT_FALSE, которое означает, что набор строк не поддерживает закладки. Набор строк представляет собой последовательность, и значения свойств DBPROP_LITERALBOOKMARKS и DBPROP_ORDEREDBOOKMARKS не учитываются.

DBPROP_BOOKMARKTYPE

  • Тип: VT_UI4

  • Стандартная операция чтения-записи: только для чтения

  • Описание: тип закладки

  • Примечание. Указывает тип закладки, поддерживаемый набором строк. Для этого поставщика значение всегда — DBPROPVAL_BMK_NUMERIC. Это указывает на цифровой тип закладок. Цифровые закладки определяются свойствами строки и не зависят от значений в столбцах строки. Например, цифровая закладка может определяться абсолютным положением строки в наборе строк либо идентификатором строки, назначенным ядром хранилища данных при создании этой строки. Изменение столбцов строки не влияет на верность закладки.

    Тип закладок — DBTYPE_UI4. В версиях, предшествующих SQL Server Compact 3.5, закладки принадлежали к типу DBTYPE_I4

DBPROP_CANFETCHBACKWARDS

  • Тип: VT_BOOL

  • Стандартная операция чтения-записи: чтение и запись

  • Описание: обратная выборка

  • Примечание. Указывает, может ли набор строк выполнять выборку в обратном порядке. Поставщик поддерживает следующие значения:

    • VARIANT_TRUE, которое означает, что cRows в IRowset::GetNextRows может быть отрицательным. В этом случае данный метод выполняет выборку с указанной строки в обратном порядке;

    • VARIANT_FALSE, которой указывает, что значение cRows не может быть отрицательным.

DBPROP_CANHOLDROWS

  • Тип: VT_BOOL

  • Стандартная операция чтения-записи: чтение

  • Описание: хранение строк

  • Примечание. Для данного поставщика это свойство всегда равно VARIANT_FALSE.

DBPROP_CANSCROLLBACKWARDS

  • Тип: VT_BOOL

  • Стандартная операция чтения-записи: чтение

  • Описание: обратная прокрутка

  • Примечание. Для данного поставщика это свойство всегда равно VARIANT_FALSE. Это указывает на то, что значение IRowsOffset не может быть отрицательным

DBPROP_CHANGEINSERTEDROWS

  • Тип: VT_BOOL

  • Стандартная операция чтения-записи: чтение

  • Описание: изменение вставленных строк

  • Примечание. Для данного поставщика значение всегда равно VARIANT_TRUE. Это означает, что потребитель может вызвать IRowsetChange::DeleteRows или IRowsetChange::SetData для вновь вставленных строк. Вновь вставленная строка определяется как строка, команда о вставке которой была передана в хранилище данных, а не в очередь вставки строк

DBPROP_COMMITPRESERVE

  • Тип: VT_BOOL

  • Стандартная операция чтения-записи: только для чтения

  • Описание: сохранять при фиксации

  • Примечание. Для данного поставщика значение всегда равно VARIANT_TRUE. Это означает, что после фиксации с сохранением набор строк остается активным и с ним можно выполнять различные операции, в том числе делать выборку новых строк, обновлять, удалять и вставлять новые строки.

DBPROP_DEFERRED

  • Тип: VT_BOOL

  • Стандартная операция чтения-записи: только для чтения

  • Описание: отложенные столбцы

  • Примечание. Для данного поставщика значение всегда равно VARIANT_TRUE. Это означает, что выборка данных из столбца не выполняется, пока к столбцу не будет применен метод доступа

DBPROP_DELAYSTORAGEOBJECTS

  • Тип: VT_BOOL

  • Стандартная операция чтения-записи: только для чтения

  • Описание: отложенное обновление объекта хранения

  • Примечание. Для данного поставщика значение всегда равно VARIANT_TRUE. Это означает, что объекты хранилища данных также используются в режиме отложенного обновления

DBPROP_IAccessor

DBPROP_IColumnsInfo

DBPROP_IConvertType

DBPROP_IRowset

DBPROP_IRowsetChange

DBPROP_IRowsetInfo

DBPROP_IRowsetUpdate

DBPROP_ISupportErrorInfo

DBPROP_IRowsetIndex

DBPROP_IRowsetCurrentIndex

DBPROP_IRowsetBookmark

  • Тип: VT_BOOL

  • Стандартная операция чтения-записи: чтение-запись, за исключением примечаний, описанных далее.

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

    • DBPROP_IAccessor

    • DBPROP_IColumnsInfo

    • BPROP_IConvertType

    • DBPROP_IRowset

    • DBPROP_IRowsetInfo

    • DBPROP_ISupportErrorInfo

    Если для DBPROP_IRowsetUpdate указать значение VARIANT_TRUE, то для DBPROP_IRowsetChange будет автоматически задано значение VARIANT_TRUE. Если для DBPROP_IRowsetCurrentIndex указать значение VARIANT_TRUE, то для DBPROP_IRowsetIndex будет автоматически задано значение VARIANT_TRUE

DBPROP_ILockBytes

DBPROP_ISequentialStream

  • Тип: VT_BOOL

  • Стандартная операция чтения-записи: чтение и запись

  • Примечание. Если свойство имеет значение VARIANT_TRUE, то конкретный столбец рассматривается как объект хранилища, который реализует соответствующий интерфейс.

DBPROP_IMMOBILEROWS

  • Тип: VT_BOOL

  • Стандартная операция чтения-записи: только для чтения

  • Описание: немобильные строки

  • Примечание. Для данного поставщика значение всегда равно VARIANT_FALSE. Это означает, что если набор строк упорядочен, то вставленные и обновленные строки (в которых обновлены один или несколько столбцов в критериях упорядочивания) соответствуют критериям упорядочивания набора. Если набор строк не упорядочен, то нет гарантий, что вставленные строки появятся в определенном положении, а положение обновленных строк не изменится. Это свойство имеет значение, только если для DBPROP_OWNINSERT задано VARIANT_TRUE

DBPROP_LOCKMODE

  • Тип: VT_I4

  • Операция чтения-записи: чтение

  • Описание: режим блокировки

  • Примечание. Для данного поставщика значение всегда равно DBPROPVAL_LM_SINGLEROW.

DBPROP_MAXOPENROWS

  • Тип: VT_I4

  • Стандартная операция чтения-записи: чтение

  • Описание: максимальное число открытых строк

  • Примечание. Это значение для SQL Server Compact 3.5 равно 1.

DBPROP_MAXROWS

  • Тип: VT_I4

  • Стандартная операция чтения-записи: только для чтения

  • Описание: максимальное число строк

  • Примечание. Указывает максимальное число строк, которое может быть возвращено в наборе строк. При значении «0» ограничений не существует. Для данного поставщика значение всегда равно 0.

DBPROP_OTHERINSERT

  • Тип: VT_BOOL

  • Стандартная операция чтения-записи: чтение и запись

  • Описание: прочие операции вставки.

  • Примечание. Для базовых таблиц равно TRUE, для прочих — FALSE.

DBPROP_OTHERUPDATEDELETE

  • Тип: VT_BOOL

  • Стандартная операция чтения-записи: чтение и запись

  • Описание: видны прочие изменения

  • Примечание. Укажите одно из следующих значений.

    • VARIANT_TRUE, указывающее, что набор строк определяет результаты операций обновления или удаления, выполненных пользователем, который не является потребителем данного набора строк. Например, предположим, что пользователь, не являющийся потребителем набора строк, обновил базовые данные в строке или удалил строку. Если строка освобождена полностью, изменения будут видимы для любого потребителя набора строк при следующей выборке строки. Это распространяется на операции обновления и удаления, выполненные другими участниками той же транзакции, равно как и сторонами за пределами транзакции. Уровень изоляции транзакции не влияет на видимость для набора строк изменений, внесенных другими участниками транзакции, например другими наборами строк в том же сеансе. Однако он налагает ограничения на способность набора строк определять изменения, внесенные сторонами за пределами транзакции.

    • VARIANT_FALSE, означающее, что чужие изменения не определяются данным набором строк.

DBPROP_OWNINSERT

  • Тип: VT_BOOL

  • Стандартная операция чтения-записи: чтение и запись

  • Описание: видны собственные операции вставки

DBPROP_OWNUPDATEDELETE

  • Тип: VT_BOOL

  • Стандартная операция чтения-записи: чтение и запись

  • Описание: видны собственные изменения

DBPROP_QUICKRESTART

  • Тип: VT_BOOL

  • Стандартная операция чтения-записи: чтение и запись

  • Описание: быстрый перезапуск

DBPROP_REMOVEDELETED

  • Тип: VT_BOOL

  • Стандартная операция чтения-записи: чтение

  • Описание: удаление удаленных строк

  • Примечание. Для данного поставщика значение всегда равно VARIANT_TRUE.

DBPROP_REPORTMULTIPLECHANGES

  • Тип: VT_BOOL

  • Стандартная операция чтения-записи: только для чтения

  • Описание: сообщать о множественных изменениях

  • Примечание. Для данного поставщика значение всегда равно VARIANT_TRUE.

DBPROP_ROWTHREADMODEL

  • Тип: VT_I4

  • Стандартная операция чтения-записи: только для чтения

  • Описание: определяет модель потоков для наборов строк, созданных командой. Для этого поставщика значение всегда — DBPROPVAL_RT_SINGLETHREAD

DBPROP_SERVERDATAONINSERT

  • Тип: VT_BOOL

  • Операция чтения-записи: чтение

  • Описание: данные сервера при операции вставки

  • Примечание. Для данного поставщика значение всегда равно VARIANT_TRUE.

DBPROP_UPDATABILITY

  • Тип: VT_I4

  • Стандартная операция чтения-записи: чтение и запись

  • Описание: возможность обновления