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。
要求
特性上下文 | 值 |
---|---|
适用于 | %> |
可重复 | 否 |
必需的特性 | 无 |
无效的特性 | 无 |
有关特性上下文的详细信息,请参见 特性上下文。