db_table

打开 OLE DB 表。

语法

[ db_table(db_table, name, source_name, hresult) ]

参数

db_table
一个字符串,指定数据库表的名称(例如“Products”)。

name
(可选)用于处理表的句柄名称。 如果要返回多个结果行,则必须指定此参数。 db_table 生成一个具有指定名称的变量,该变量可用于遍历行集或执行多个操作查询。

source_name
(可选)向其应用 db_source 特性的类的 CSession 变量或实例(在其上运行命令)。 请参阅 db_source

hresult
(可选)标识将接收此数据库命令的 HRESULT 的变量。 如果该变量不存在,属性将自动插入。

注解

db_table 创建一个 CTable 对象,OLE DB 使用者使用它来打开表。 只能在类级别使用此属性;不能内联使用它。 使用 db_column 将表列绑定到变量;使用 db_param 来分隔参数(设置参数类型等)。

使用者特性提供程序将此特性应用到某个类时,编译器会将该类重命名为 _YourClassNameAccessor,其中 YourClassName 是为类命名的名称,且编译器还将创建一个派生自 _YourClassNameAccessor、名为 YourClassName 的类。 将在类视图中看到这两个类。

示例

以下示例打开 Products 表以供 CProducts 使用。

// db_table.cpp
// compile with: /LD
#include <atlbase.h>
#include <atlplus.h>
#include <atldbcli.h>

[ db_table(L"dbo.Products") ]
class CProducts {
   [ db_column("1") ] LONG m_ProductID;
};

有关应用程序中使用此特性的示例,请参阅 MultiRead

要求

特性上下文
适用于 %>
可重复
必需的特性
无效的特性

有关特性上下文的详细信息,请参见 特性上下文

另请参阅

OLE DB 使用者特性