使用数据库属性简化数据访问
更新：2007 年 11 月
本主题说明如何使用数据库属性简化数据库操作。
访问数据库中信息的基本方法是针对数据库中的特定表创建命令（或表）类和用户记录类。数据库属性简化了先前必须进行的一些模板声明。
为说明数据库属性的用法，下面各节介绍两个等效的表和用户记录类声明：第一个使用属性，第二个则使用 OLE DB 模板。这类声明代码通常放置在头文件中，以表或命令对象命名，例如 Authors.h。
通过比较这两个文件，便可以看出使用属性是多么简单。两者的差异包括：
如果使用属性，则只需声明一个类：CAuthors，而使用模板则必须声明两个类：CAuthorsNoAttrAccessor 和 CAuthorsNoAttr。
属性化版本中的 db_source 调用等效于模板声明中的 OpenDataSource() 调用。
属性化版本中的 db_table 调用等效于以下模板声明：
class CAuthorsNoAttr : public CTable<CAccessor<CAuthorsNoAttrAccessor> >属性化版本中的 db_column 调用等效于模板声明中的列映射（请参见 BEGIN_COLUMN_MAP ... END_COLUMN_MAP）。
属性将为您插入用户记录类声明。此用户记录类等效于模板声明中的 CAuthorsNoAttrAccessor。如果表类为 CAuthors，则插入的用户记录类命名为 CAuthorsAccessor，并且只能在插入的代码中查看其声明。有关更多信息，请参见用户记录中的“属性插入的用户记录类”。
注意，在属性化代码和模板化代码中，都必须使用 CDBPropSet::AddProperty 设置行集合属性。
有关本主题中所讨论的属性的信息，请参见 OLE DB 使用者属性。
使用属性进行表和访问器声明
以下代码在表类上调用 db_source 和 db_table。db_source 指定要使用的数据源和连接。db_table 插入适当的模板代码以声明表类。db_column 指定列映射并插入访问器声明。可以使用支持 ATL 的任何项目中的 OLE DB 使用者属性。
以下是使用属性进行的表和访问器声明：
//////////////////////////////////////////////////////////////////////
// Table and accessor declaration using attributes
// authors.h
//////////////////////////////////////////////////////////////////////
// Table class declaration
// (Note that you must provide your own connection string for db_source.)
[
db_source(L"your connection string"),
db_table("Authors")
]
class CAuthors
{
public:
DWORD m_dwAuIDStatus;
DWORD m_dwAuthorStatus;
DWORD m_dwYearBornStatus;
DWORD m_dwAuIDLength;
DWORD m_dwAuthorLength;
DWORD m_dwYearBornLength;
[ db_column(1, status=m_dwAuIDStatus, length=m_dwAuIDLength) ] LONG m_AuID;
[ db_column(2, status=m_dwAuthorStatus, length=m_dwAuthorLength) ] TCHAR m_Author[51];
[ db_column(3, status=m_dwYearBornStatus, length=m_dwYearBornLength) ] SHORT m_YearBorn;
void GetRowsetProperties(CDBPropSet* pPropSet)
{
pPropSet->AddProperty(DBPROP_CANFETCHBACKWARDS, true);
pPropSet->AddProperty(DBPROP_CANSCROLLBACKWARDS, true);
pPropSet->AddProperty(DBPROP_IRowsetChange, true);
}
};
使用模板的表和访问器声明
以下是使用模板的表和访问器声明。
//////////////////////////////////////////////////////////////////////
// Table and user record class declaration using templates
// authors.h
//////////////////////////////////////////////////////////////////////
// User record class declaration
class CAuthorsNoAttrAccessor
{
public:
DWORD m_dwAuIDStatus;
DWORD m_dwAuthorStatus;
DWORD m_dwYearBornStatus;
DWORD m_dwAuIDLength;
DWORD m_dwAuthorLength;
DWORD m_dwYearBornLength;
LONG m_AuID;
TCHAR m_Author[51];
SHORT m_YearBorn;
void GetRowsetProperties(CDBPropSet* pPropSet)
{
pPropSet->AddProperty(DBPROP_CANFETCHBACKWARDS, true);
pPropSet->AddProperty(DBPROP_CANSCROLLBACKWARDS, true);
pPropSet->AddProperty(DBPROP_IRowsetChange, true);
}
HRESULT OpenDataSource()
{
CDataSource _db;
HRESULT hr;
hr = _db.OpenFromInitializationString(L"your connection string");
if (FAILED(hr))
{
#ifdef _DEBUG
AtlTraceErrorRecords(hr);
#endif
return hr;
}
return m_session.Open(_db);
}
void CloseDataSource()
{
m_session.Close();
}
operator const CSession&()
{
return m_session;
}
CSession m_session;
BEGIN_COLUMN_MAP(CAuthorsNoAttrAccessor)
COLUMN_ENTRY_LENGTH_STATUS(1, m_AuID, m_dwAuIDLength, m_dwAuIDStatus)
COLUMN_ENTRY_LENGTH_STATUS(2, m_Author, m_dwAuthorLength, m_dwAuthorStatus)
COLUMN_ENTRY_LENGTH_STATUS(3, m_YearBorn, m_dwYearBornLength, m_dwYearBornStatus)
END_COLUMN_MAP()
};
class CAuthorsNoAttr : public CTable<CAccessor<CAuthorsNoAttrAccessor> >
{
public:
HRESULT OpenAll()
{
HRESULT hr;
hr = OpenDataSource();
if (FAILED(hr))
return hr;
__if_exists(GetRowsetProperties)
{
CDBPropSet propset(DBPROPSET_ROWSET);
__if_exists(HasBookmark)
{
propset.AddProperty(DBPROP_IRowsetLocate, true);
}
GetRowsetProperties(&propset);
return OpenRowset(&propset);
}
__if_not_exists(GetRowsetProperties)
{
__if_exists(HasBookmark)
{
CDBPropSet propset(DBPROPSET_ROWSET);
propset.AddProperty(DBPROP_IRowsetLocate, true);
return OpenRowset(&propset);
}
}
return OpenRowset();
}
HRESULT OpenRowset(DBPROPSET *pPropSet = NULL)
{
HRESULT hr = Open(m_session, "Authors", pPropSet);
#ifdef _DEBUG
if(FAILED(hr))
AtlTraceErrorRecords(hr);
#endif
return hr;
}
void CloseAll()
{
Close();
CloseDataSource();
}
};