Szablony konsumentów OLE DB — kompendium
Szablony konsumentów OLE DB zawierają następujące klasy. Materiał referencyjny zawiera również tematy dotyczące makr szablonów konsumentów OLE DB.
Klasy sesji
CDataConnection
Zarządza połączeniem ze źródłem danych. Jest to przydatna klasa do tworzenia klientów, ponieważ hermetyzuje niezbędne obiekty (źródło danych i sesja) oraz niektóre zadania, które należy wykonać podczas nawiązywania połączenia ze źródłem danych.
CDataSource
Odpowiada obiektowi źródła danych OLE DB reprezentującemu połączenie za pośrednictwem dostawcy ze źródłem danych. Co najmniej jedna sesja bazy danych, każda reprezentowana przez CSession obiekt, może odbywać się w jednym połączeniu.
CEnumerator
Odpowiada obiektowi wyliczającego OLE DB, który pobiera informacje zestawu wierszy o dostępnych źródłach danych.
CEnumeratorAccessor
Używany przez CEnumerator do uzyskiwania dostępu do danych z zestawu wierszy modułu wyliczającego. Ten zestaw wierszy składa się ze źródeł danych i modułów wyliczanych widocznych z bieżącego modułu wyliczającego.
CSession
Reprezentuje pojedynczą sesję dostępu do bazy danych. Co najmniej jedna sesja może być skojarzona z każdym CDataSource obiektem.
Klasy akcesoriów
CAccessor
Służy do obsługi rekordów, które są statycznie powiązane ze źródłem danych. Użyj tej klasy akcesoriów, gdy znasz strukturę źródła danych.
CAccessorBase
Klasa bazowa dla wszystkich klas akcesoriów.
CDynamicAccessor
Akcesorium, które można utworzyć w czasie wykonywania, na podstawie informacji o kolumnie zestawu wierszy. Użyj tej klasy, aby pobrać dane, jeśli nie znasz struktury źródła danych.
CDynamicParameterAccessor
Metodę dostępu, która może być używana, gdy typy poleceń są nieznane. Uzyskuje informacje o parametrach przez wywołanie interfejsu ICommandWithParameters , jeśli dostawca obsługuje interfejs.
CDynamicStringAccessor
Umożliwia dostęp do źródła danych, gdy nie masz wiedzy o podstawowej strukturze bazy danych.
CDynamicStringAccessorA
Podobnie jak w przypadku, gdy CDynamicStringAccessor ta klasa żąda dostępu do danych z magazynu danych jako dane ciągu ANSI.
CDynamicStringAccessorW
Podobnie jak w przypadku, gdy CDynamicStringAccessor ta klasa żąda dostępu do danych z magazynu danych jako dane ciągu UNICODE.
CManualAccessor
Metoda dostępu do obsługi zarówno kolumn, jak i parametrów polecenia. W tej klasie można używać dowolnych typów danych, o ile dostawca może przekonwertować typ.
CNoAccessor
Można użyć jako argumentu szablonu, gdy nie chcesz, aby klasa obsługiwała parametry lub kolumny wyjściowe.
CXMLAccessor
Podobnie jak w przypadku CDynamicStringAccessor , gdy ta klasa konwertuje wszystkie dane dostępne z magazynu danych jako dane sformatowane w formacie XML (oznakowane).
Klasy zestawu wierszy
CAccessorRowset
Hermetyzuje zestaw wierszy i skojarzone z nim metody dostępu.
CArrayRowset
Służy do uzyskiwania dostępu do elementów zestawu wierszy przy użyciu składni tablicy.
CBulkRowset
Służy do pobierania wierszy i manipulowania nimi zbiorczo przez pobieranie wielu dojść wierszy za pomocą jednego wywołania.
CNoRowset
Można użyć jako argumentu szablonu, jeśli polecenie nie zwraca zestawu wierszy.
CRestrictions
Służy do określania ograniczeń dla zestawów wierszy schematu.
CRowset
Służy do manipulowania, ustawiania i pobierania danych zestawu wierszy.
CStreamRowset
ISequentialStream Zwraca obiekt, a nie zestaw wierszy, a następnie używasz Read metody do pobierania danych w formacie XML. (Program SQL Server 2000 obsługuje formatowanie; należy pamiętać, że ta funkcja działa tylko z programem SQL Server 2000).
IRowsetNotifyImpl
Zapewnia fikcyjną implementację dla IRowsetNotifyklasy , z pustymi funkcjami metod IRowsetNotify OnFieldChange, OnRowChangei OnRowsetChange.
Klasy zestawów wierszy schematu i klasy Typedef
Szablony OLE DB udostępniają zestaw klas odpowiadających zestawom wierszy schematu OLE DB.
Klasy poleceń
CCommand
Służy do ustawiania i wykonywania polecenia OLE DB opartego na parametrach. Aby otworzyć prosty zestaw wierszy, należy zamiast tego użyć polecenia CTable .
CMultipleResults
Używany jako argument szablonu dla szablonu CCommand , gdy chcesz, aby polecenie obsługiwało wiele zestawów wyników.
CNoAccessor
Używany jako argument szablonu dla klas szablonów, takich jak CCommand i CTable, które przyjmują argument klasy dostępu. Użyj polecenia CNoAccessor , jeśli nie chcesz, aby klasa obsługiwała parametry lub kolumny wyjściowe.
CNoMultipleResults
Używany jako argument szablonu dla szablonu CCommand , gdy chcesz, aby polecenie obsługiwało pojedynczy zestaw wierszy. CNoMultipleResults jest wartością domyślną argumentu szablonu.
CNoRowset
Używany jako argument szablonu dla CCommand polecenia lub CTable tabeli nie zwraca zestawu wierszy.
Tabela CTable
Służy do uzyskiwania dostępu do prostego zestawu wierszy bez parametrów.
Klasy właściwości
ZESTAW CDBPropIDSet
Służy do przekazywania tablicy identyfikatorów właściwości, dla których odbiorca chce uzyskać informacje o właściwości. Właściwości należą do jednego zestawu właściwości.
CDBPropSet
Służy do ustawiania właściwości u dostawcy.
Klasa zakładek
CBookmark
Używany jako indeks do uzyskiwania dostępu do danych w zestawie wierszy.
Error, klasa
CDBErrorInfo
Służy do pobierania informacji o błędzie OLE DB.