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


Свойства набора строк (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 2005 Compact Edition закладки принадлежали к типу 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 Edition значение этого свойства — 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
  • Чтение/запись: чтение и запись
  • Описание: возможность обновления

См. также

Справка и поддержка

Получение помощи по SQL Server Compact Edition