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


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

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

Cвойство Описание

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
  • Стандартная операция чтения-записи: R
  • Описание: Хранение строк
  • Примечания: Для данного поставщика это свойство всегда равно VARIANT_FALSE.

DBPROP_CANSCROLLBACKWARDS

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

DBPROP_CHANGEINSERTEDROWS

  • Тип: VT_BOOL
  • Стандартная операция чтения-записи: R
  • Описание: Изменение вставленных строк
  • Примечания Для данного поставщика значение всегда равно 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
  • Чтение-запись: R
  • Описание: Режим блокировки
  • Примечания Для данного поставщика значение всегда будет равно DBPROPVAL_LM_SINGLEROW.

DBPROP_MAXOPENROWS

  • Тип: VT_I4
  • Стандартная операция чтения-записи: R
  • Описание: Максимальное число открытых строк
  • Примечания Это значение для 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
  • Стандартная операция чтения-записи: R
  • Описание: Удаление удаленных строк
  • Примечания Для данного поставщика значение всегда равно VARIANT_TRUE.

DBPROP_REPORTMULTIPLECHANGES

  • Тип: VT_BOOL
  • Стандартная операция чтения-записи: только для чтения
  • Описание: Сообщать о множественных изменениях
  • Примечания Для данного поставщика значение всегда равно VARIANT_TRUE.

DBPROP_ROWTHREADMODEL

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

DBPROP_SERVERDATAONINSERT

  • ТИП: VT_BOOL
  • Чтение-запись: R
  • Описание: Данные сервера при операции вставки
  • Примечания Для данного поставщика значение всегда равно VARIANT_TRUE.

DBPROP_UPDATABILITY

  • Тип: VT_I4
  • Стандартная операция чтения-записи: Чтение или запись
  • Описание: Возможность обновления