通过

行集属性 (OLE DB)

DBPROPSET_ROWSET 属性集包含以下属性。所有这些属性都位于行集属性组中。还有一些属性是在 DBPROPSET_SSCE_ROWSET 中定义的。

属性 ID

说明

DBPROP_ABORTPRESERVE

  • 类型：VT_BOOL

  • 典型读/写：只读

  • 说明：中止时保留

  • 注释：对于此提供程序，该值始终为 VARIANT_FALSE。这指示在中止事务后，在行集上只允许两个操作，即释放行和取值函数句柄以及释放行集。

DBPROP_ACCESSORDER

  • 类型：VT_I4

  • R/W：只读

  • 说明：访问顺序

  • 注释：对于此提供程序，该值始终为 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。它指示书签类型是数字型。数字型书签以行属性为基础，不依赖于行的列值。例如，数字型书签可以基于行集中行的绝对位置，或者基于存储引擎在创建行时分配给行的行 ID。修改行的列不会更改数字型书签的有效性。

    书签的类型为 DBTYPE_UI4。在 SQL Server Compact 之前的版本中，书签的类型为 DBTYPE_I4

DBPROP_CANFETCHBACKWARDS

  • 类型：VT_BOOL

  • 典型读/写：读/写

  • 说明：向后获取

  • 注释：指定行集是否可以向后获取。访问接口支持以下各值：

    • VARIANT_TRUE，指示 IRowset::GetNextRows 中的 cRows 可以为负。当它为负时，该方法将从指定行向后提取行。

    • 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

  • TYPE：VT_I4

  • 读/写：读

  • 说明：锁定模式

  • 注释：对于此提供程序，该值始终为 DBPROPVAL_LM_SINGLEROW。

DBPROP_MAXOPENROWS

  • 类型：VT_I4

  • 典型读/写：读

  • 说明：最大打开行数

  • 注释：对于 SQL Server Compact，此值为 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

  • 典型读/写：读/写

  • 说明：可更新性