Klasa CDaoRecordset

Artykuł
06/10/2015

Reprezentuje zestaw rekordów wybranych ze źródła danych.

class CDaoRecordset : public CObject

Członkowie

Publiczne konstruktory

Nazwa	Opis
CDaoRecordset::CDaoRecordset	Konstrukcje CDaoRecordset obiektu.

Metody publiczne

Nazwa	Opis
CDaoRecordset::AddNew	Przygotowuje się do dodawania nowego rekordu.Wywołanie Aktualizacja do ukończenia dodanie.
CDaoRecordset::CanAppend	Zwraca wartość niezerową, jeżeli nowe rekordy, które można dodać do zestawu rekordów za pomocą AddNew funkcji składowej.
CDaoRecordset::CanBookmark	Zwraca wartość niezerową, jeśli zestaw rekordów obsługuje zakładek.
CDaoRecordset::CancelUpdate	Anuluje wszystkie oczekujące aktualizacje, ze względu na Edytuj lub AddNew operacji.
CDaoRecordset::CanRestart	Jeżeli niezerowych zwraca Requery można wywołać ponownie uruchomić kwerendę rekordów.
CDaoRecordset::CanScroll	Zwraca wartość niezerową, jeśli można przewijać rekordy.
CDaoRecordset::CanTransact	Zwraca wartość niezerową, jeśli źródło danych obsługuje transakcje.
CDaoRecordset::CanUpdate	Zwraca wartość niezerową, zaktualizowaniu rekordów (można dodać, zaktualizować lub usunąć rekordy).
CDaoRecordset::Close	Zamyka zestawu rekordów.
CDaoRecordset::Delete	Usuwa bieżący rekord w zestawie.Należy jawnie przewiń do innego rekordu po usunięciu.
CDaoRecordset::DoFieldExchange	Nazywane wymiany danych (w obu kierunkach) między członkami pola danych zestawu rekordów i odpowiadającego mu rekordu w źródle danych.Implementuje DAO rejestrować wymiany pól (DFX).
CDaoRecordset::Edit	Przygotowuje się do zmian w bieżącym rekordzie.Wywołanie Aktualizacja do wykonania do edycji.
CDaoRecordset::FillCache	Wypełnienia wszystkich lub części lokalnej pamięci podręcznej dla obiektu zestaw rekordów, który zawiera dane ze źródła danych ODBC.
CDaoRecordset::Find	Lokalizuje następnego pierwszego, poprzedniego lub ostatniej lokalizacji określonego ciągu w dynamicznego zestawu rekordów, który spełnia określone kryteria i ułatwia, które rejestrowanie bieżącego rekordu.
CDaoRecordset::FindFirst	Lokalizuje pierwszy rekord w dynamicznego lub rekordów typu migawka, który spełnia określone kryteria i ułatwia, które rejestrowanie bieżącego rekordu.
CDaoRecordset::FindLast	Lokalizuje ostatni rekord w dynamicznego lub rekordów typu migawka, który spełnia określone kryteria i ułatwia, które rejestrowanie bieżącego rekordu.
CDaoRecordset::FindNext	Lokalizuje następnego rekordu w dynamicznego lub rekordów typu migawka, który spełnia określone kryteria i ułatwia, które rejestrowanie bieżącego rekordu.
CDaoRecordset::FindPrev	Lokalizuje poprzedniego rekordu w dynamicznego lub rekordów typu migawka, który spełnia określone kryteria i ułatwia, które rejestrowanie bieżącego rekordu.
CDaoRecordset::GetAbsolutePosition	Zwraca numer rekordu bieżącego rekordu w obiekcie recordset.
CDaoRecordset::GetBookmark	Zwraca wartość, która reprezentuje zakładki do rekordu.
CDaoRecordset::GetCacheSize	Zwraca wartość, która określa liczbę rekordów zawierających dane ze źródła danych ODBC lokalnie buforowania dynamicznego zestawu rekordów.
CDaoRecordset::GetCacheStart	Zwraca wartość, która określa zakładkę pierwszy rekord w zestawie rekordów w pamięci podręcznej.
CDaoRecordset::GetCurrentIndex	Zwraca CString zawierający nazwę indeksu, najbardziej niedawno używanych w indeksowanych, typ tabeli CDaoRecordset.
CDaoRecordset::GetDateCreated	Zwraca datę i godzinę podstawowej tabeli bazowej CDaoRecordset obiekt został utworzony.
CDaoRecordset::GetDateLastUpdated	Zwraca datę i godzinę ostatniej zmiany do projektu tabeli bazowej podstawowych CDaoRecordset obiektu.
CDaoRecordset::GetDefaultDBName	Zwraca nazwę domyślne źródło danych.
CDaoRecordset::GetDefaultSQL	Nazywane uzyskać domyślny ciąg SQL do wykonania.
CDaoRecordset::GetEditMode	Zwraca wartość, która wskazuje stan edycji dla bieżącego rekordu.
CDaoRecordset::GetFieldCount	Zwraca wartość, która reprezentuje liczbę pól w zestawie rekordów.
CDaoRecordset::GetFieldInfo	Zwraca określonych rodzajów informacji dotyczących pól w zestawie rekordów.
CDaoRecordset::GetFieldValue	Zwraca wartość pola w zestawie rekordów.
CDaoRecordset::GetIndexCount	Pobiera numer indeksów w tabeli podstawowej zestawu rekordów.
CDaoRecordset::GetIndexInfo	Zwraca różnego rodzaju informacje o indeksie.
CDaoRecordset::GetLastModifiedBookmark	Używane do określenia najbardziej ostatnio dodane lub zaktualizowane rekordu.
CDaoRecordset::GetLockingMode	Zwraca wartość, która wskazuje typ blokowania obowiązuje podczas edycji.
CDaoRecordset::GetName	Zwraca CString zawierający nazwę zestawu rekordów.
CDaoRecordset::GetParamValue	Pobiera bieżącą wartość określonego parametru, przechowywanych w obiekcie DAOParameter podstawowej.
CDaoRecordset::GetPercentPosition	Zwraca pozycję bieżącego rekordu jako procent całkowitej liczby rekordów.
CDaoRecordset::GetRecordCount	Zwraca liczbę rekordów dostępne w obiekcie recordset.
CDaoRecordset::GetSQL	Pobiera ciąg SQL używany do wybierania rekordów dla zestawu rekordów.
CDaoRecordset::GetType	Wywołana, aby określić typ zestawu rekordów: typ tabeli, dynamicznego lub typu migawka.
CDaoRecordset::GetValidationRule	Zwraca CString zawierających sprawdzania danych jest wprowadzana w polu wartość.
CDaoRecordset::GetValidationText	Odczytuje tekst wyświetlany, gdy reguła sprawdzania poprawności nie jest spełniony.
CDaoRecordset::IsBOF	Zwraca wartość niezerową, jeśli zestaw rekordów ma został umieszczony przed pierwszego rekordu.Brak bieżącego rekordu.
CDaoRecordset::IsDeleted	Zwraca wartość niezerową, jeśli zestaw rekordów jest umieszczony w usuniętym rekordzie.
CDaoRecordset::IsEOF	Zwraca wartość niezerową, jeśli zestaw rekordów ma został umieszczony po ostatnim rekordzie.Brak bieżącego rekordu.
CDaoRecordset::IsFieldDirty	Zwraca wartość niezerową, jeśli zmienił określonego pola w bieżącym rekordzie.
CDaoRecordset::IsFieldNull	Zwraca wartość niezerową, jeśli określonego pola w bieżącym rekordzie ma wartość Null (wartość nie posiadający).
CDaoRecordset::IsFieldNullable	Zwraca wartość niezerową, jeśli określonego pola w bieżącym rekordzie można ustawić wartość NULL (wartość nie posiadający).
CDaoRecordset::IsOpen	Jeżeli niezerowych zwraca Otwórz została wywołana wcześniej.
CDaoRecordset::Move	Pozycji zestawu rekordów w określonej liczby rekordów z bieżącego rekordu w dowolnym kierunku.
CDaoRecordset::MoveFirst	Pozycje bieżącego rekordu na pierwszy rekord w zestawie rekordów.
CDaoRecordset::MoveLast	Pozycje bieżącego rekordu na ostatni rekord w zestawie rekordów.
CDaoRecordset::MoveNext	Pozycje bieżącego rekordu następnego rekordu w zestawie rekordów.
CDaoRecordset::MovePrev	Pozycje bieżącego rekordu z poprzedniego rekordu w zestawie rekordów.
CDaoRecordset::Open	Tworzy nowy zestaw rekordów z tabeli, dynamiczny lub migawki.
CDaoRecordset::Requery	Uruchamia kwerendę rekordów ponownie, aby odświeżyć zaznaczone rekordy.
CDaoRecordset::Seek	Lokalizuje rekordu w obiekcie recordset indeksowanej tabeli, która spełnia określone kryteria dla bieżącego indeksu i ułatwia, które rejestrowanie bieżącego rekordu.
CDaoRecordset::SetAbsolutePosition	Określa numer rekordu bieżącego rekordu w obiekcie recordset.
CDaoRecordset::SetBookmark	Pozycje zestawu rekordów do rekordu zawierającego zakładką.
CDaoRecordset::SetCacheSize	Ustawia wartość, która określa liczbę rekordów zawierających dane ze źródła danych ODBC lokalnie buforowania dynamicznego zestawu rekordów.
CDaoRecordset::SetCacheStart	Ustawia wartość, która określa zakładkę pierwszy rekord w zestawie rekordów w pamięci podręcznej.
CDaoRecordset::SetCurrentIndex	Wywoływana do indeksu na zestawie rekordów z tabeli typu.
CDaoRecordset::SetFieldDirty	Oznaczenie określonego pola w bieżącym rekordzie, jako zmieniony.
CDaoRecordset::SetFieldNull	Ustawia wartość określonego pola w bieżącym rekordzie wartość NULL (wartość nie posiadający).
CDaoRecordset::SetFieldValue	Ustawia wartość pola w zestawie rekordów.
CDaoRecordset::SetFieldValueNull	Ustawia wartość pola w zestawie rekordów na Null.(posiadający żadnej wartości).
CDaoRecordset::SetLockingMode	Ustawia wartość wskazującą typ blokowania wprowadzone w życie w trakcie edycji.
CDaoRecordset::SetParamValue	Ustawia wartość bieżącego określony parametr przechowywanych w obiekcie DAOParameter podstawowej
CDaoRecordset::SetParamValueNull	Ustawia określony parametr bieżącą wartość Null (wartość nie posiadający).
CDaoRecordset::SetPercentPosition	Ustawia położenie bieżącego rekordu w lokalizacji odpowiadającej procent całkowitej liczby rekordów w zestawie rekordów.
CDaoRecordset::Update	Kończy AddNew lub Edytuj operacji przez zapisanie nowej lub edytowanej danych w źródle danych.

Publiczne danych członków

Nazwa	Opis
CDaoRecordset::m_bCheckCacheForDirtyFields	Zawiera flagi wskazujące, czy pola są automatycznie oznaczane jako zmieniony.
CDaoRecordset::m_nFields	Zawiera numer pola danych członków w klasie rekordów i liczba kolumn wybranych przez zestaw rekordów ze źródła danych.
CDaoRecordset::m_nParams	Zawiera liczbę członków danych parametru w klasie rekordów — liczba parametrów przekazanych z rekordów kwerendy
CDaoRecordset::m_pDAORecordset	Wskaźnik do interfejsu DAO podstawę obiektu recordset.
CDaoRecordset::m_pDatabase	Baza danych źródłowych dla tego zestawu wyników.Zawiera wskaźnik do CDaoDatabase obiektu.
CDaoRecordset::m_strFilter	Zawiera ciąg używany do skonstruowania SQL gdzie instrukcji.
CDaoRecordset::m_strSort	Zawiera ciąg używany do skonstruowania SQL ORDER BY instrukcji.

Uwagi

Znane jako "zestawy rekordów," CDaoRecordset obiekty są dostępne w następujących trzech formularzach:

Zestawy rekordów z tabeli Typ reprezentują używanego do zbadania, dodać, zmienić lub usunąć rekordy z tabeli bazy danych w pojedynczej tabeli bazowej.
Zestawy rekordów dynamicznego są wynikiem kwerendy mogą mieć rekordy można aktualizować.Te zestawy rekordów są zestawem rekordów, których można zbadać, dodawanie, zmiana lub usuwanie rekordów z podstawowej tabeli bazy danych lub tabel.Zestawy rekordów dynamicznego może zawierać pola z jednej lub kilku tabel w bazie danych.
Zestawy rekordów typu migawka są statyczną kopię zestawu rekordów, które można użyć do znajdowania danych lub generować raporty.Te zestawy rekordów mogą zawierać pola z jednej lub kilku tabel w bazie danych, ale nie mogą być aktualizowane.

Każdy formularz rekordów reprezentuje zestaw rekordów, ustalone w momencie otwierania zestawu rekordów.Podczas przewijania do rekordu w zestaw rekordów typu tabeli lub dynamicznego zestawu rekordów odzwierciedla zmiany dokonane w rekordzie, po otwarciu zestawu rekordów, inni użytkownicy lub inne zestawy rekordów w aplikacji.(Nie można zaktualizować zestaw rekordów typu migawka.) Można użyć CDaoRecordset bezpośrednio lub klasę rekordów specyficzne dla aplikacji z CDaoRecordset.Następnie można:

Przewiń rekordy.
Ustawić indeksu i szybko wyszukać rekordy za pomocą Seek (tylko zestawy rekordów typu tabeli).
Znajdowanie rekordów, porównania ciągów: "<", "< =", "=", "> =", lub ">" (dynamicznego i zestawy rekordów typu migawka).
Aktualizacja rekordów i określ tryb blokowania (z wyjątkiem zestawów rekordów typu migawka).
Filtrowanie rekordów, aby ograniczyć rekordy, które wybiera spośród dostępnych w źródle danych.
Sortowanie rekordów.
Sparametryzować zestaw rekordów do dostosowywania jej wybór informacje nie są znane do czasu wykonywania.

Klasa CDaoRecordset dostarcza interfejs podobny do klasy CRecordset.Główna różnica jest klasy CDaoRecordset uzyskuje dostęp do danych za pośrednictwem obiektu DAO (Data Access) oparte na OLE.Klasa CRecordset uzyskuje dostęp do systemu DBMS poprzez Open Database Connectivity (ODBC) i sterownika ODBC dla tego systemu DBMS.

[!UWAGA]

Klasy bazy danych DAO różnią się od klasy bazy danych MFC oparte na Open Database Connectivity (ODBC).Wszystkie nazwy klasy bazy danych DAO mają prefiks "CDao".Możesz nadal dostęp do źródeł danych ODBC z klas obiektów DAO; klasy DAO ogólnie oferuje możliwości superior, ponieważ są specyficzne dla aparatu bazy danych Microsoft Jet.

Można użyć CDaoRecordset bezpośrednio lub klasę z CDaoRecordset.Aby użyć klasy rekordów w każdym przypadku, otwórz bazę danych i konstruowanie obiektu recordset, przekazując wskaźnik do konstruktora your CDaoDatabase obiektu.Można skonstruować CDaoRecordset obiektu i pozwolić utworzyć tymczasowy MFC CDaoDatabase obiekt.Następnie, wywoływać w zestawie rekordów Otwórz Członkowskich funkcji, określając, czy obiekt jest zestaw rekordów z tabeli typ, dynamicznego zestawu rekordów lub zestawu rekordów typu migawka.Wywołanie Otwórz wybiera danych z bazy danych i pobiera pierwszego rekordu.

Użyj obiektu Członkowskiego funkcji i danych członków przewiń rekordy i operują na nich.Dostępne operacje zależy, czy obiekt jest zestaw rekordów z tabeli typ, dynamicznego zestawu rekordów lub zestawu rekordów typu migawka i czy jest można aktualizować tylko do odczytu — zależy to od możliwości bazy danych lub źródło danych Open Database Connectivity (ODBC).Aby odświeżyć rekordy, które mogą zostały zmienione lub dodane od Otwórz wywołanie, wywołanie obiektu Requery funkcji składowej.Wywołanie obiektu Zamknij Członkowskich działać i zniszczyć obiekt po zakończeniu z nim.

CDaoRecordsetużywa wymiany pól rekordów DAO (DFX) do obsługi czytanie i aktualizacja pól rekordu przez członków C++ typu bezpiecznej sieci CDaoRecordset lub CDaoRecordset-klasy.Dynamiczne wiązanie kolumny można implementować w bazie danych, bez przy użyciu mechanizmu DFX GetFieldValue i SetFieldValue.

Powiązanych informacji zobacz temat "Obiektu Recordset" w pomocy DAO.