Uproszczenie dostępu do danych z bazy danych atrybutów
W tym temacie demonstruje użycie atrybutów bazy danych, aby uprościć operacji bazy danych.
Najprostszy sposób dostępu do informacji z bazy danych jest utworzenie polecenia (lub tabela) Klasa i klasa rekordu użytkownika, dla danej tabeli w bazie danych.Atrybuty bazy danych uprościć niektóre szablonu deklaracji, które uprzednio miały zrobić.
Wykazać stosowanie atrybutów bazy danych, w poniższych sekcjach przedstawiono dwie równoważne tabeli i deklaracje klas rekordu użytkownika: pierwszy używa atrybutów i druga używa szablonów OLE DB.Kod takich deklaracji jest zazwyczaj umieszczane w pliku nagłówkowym o nazwie obiektu tabeli lub polecenia na przykład Authors.h.
Przez porównanie dwóch plików, widać, jak dużo prostsze jest używanie atrybutów.Różnice są:
Przy użyciu atrybutów, tylko należy zadeklarować jedną klasę: CAuthors, podczas gdy z szablonów należy zadeklarować dwóch: CAuthorsNoAttrAccessor i CAuthorsNoAttr.
db_source Rozmowy w wersji przypisany jest równoważne z OpenDataSource() wywołania w deklaracji z szablonu.
Db_table wywołanie w wersji przypisany jest odpowiednikiem następującej deklaracji szablonu:
class CAuthorsNoAttr : public CTable<CAccessor<CAuthorsNoAttrAccessor> >Db_column połączeń w wersji przypisane są równoważne do mapy kolumny (zobacz BEGIN_COLUMN_MAP ... END_COLUMN_MAP) w deklaracji z szablonu.
Atrybuty wstrzyknąć deklaracji klasy rekordu użytkownika dla Ciebie.Klasa rekordu użytkownika jest równoważne z CAuthorsNoAttrAccessor w deklaracji z szablonu.Jeśli klasa tabeli jest CAuthors, klasa rekordu wniesiony użytkownika o nazwie CAuthorsAccessor, i jego deklaracji można wyświetlać tylko w kodzie wniesiony.Aby uzyskać więcej informacji, zobacz "Klasy rekordu użytkownika Attribute-Injected" w Rekordów użytkowników.
Należy zauważyć, że zarówno przypisane i kod opartą na szablonie, należy ustawić właściwości wierszy za pomocą CDBPropSet::AddProperty.
Aby uzyskać informacje o atrybutach, omówione w tym temacie, zobacz OLE DB konsumenta atrybutów.
Tabela i deklaracji akcesor przy użyciu atrybutów
Następujący kod dodaje do wywołań db_source i db_table w klasie tabeli.db_sourceOkreśla źródło danych i połączenia ma być używany.db_table wszczepia kod odpowiedniego szablonu, aby zadeklarować klasy tabeli.db_column określić mapę kolumny i wstrzyknąć deklaracji akcesor.Atrybuty konsumenta OLE DB można użyć w jakiegokolwiek projektu, który obsługuje ATL.
Oto deklaracji tabeli i akcesor przy użyciu atrybutów:
//////////////////////////////////////////////////////////////////////
// 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);
}
};
Tabela i deklaracji akcesor przy użyciu szablonów
Oto deklaracji tabeli i akcesor przy użyciu szablonów.
//////////////////////////////////////////////////////////////////////
// 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();
}
};