Klasa CRecordset

Artykuł
02/27/2013

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

class CRecordset : public CObject

Członkowie

Publiczne konstruktory

Nazwa	Opis
CRecordset::CRecordset	Konstrukcje CRecordset obiektu.Klasa pochodna musi dostarczyć konstruktora wywołuje ten.

Metody publiczne

Nazwa	Opis
CRecordset::AddNew	Przygotowuje się do dodawania nowego rekordu.Wywołanie Update do ukończenia dodanie.
CRecordset::CanAppend	Zwraca wartość niezerową, jeżeli nowe rekordy, które można dodać do zestawu rekordów za pomocą AddNew funkcji składowej.
CRecordset::CanBookmark	Zwraca wartość niezerową, jeśli zestaw rekordów obsługuje zakładek.
CRecordset::Cancel	Anuluje operację asynchroniczną lub procesu od drugiego wątku.
CRecordset::CancelUpdate	Anuluje wszystkie oczekujące aktualizacje, ze względu na AddNew lub Edit operacji.
CRecordset::CanRestart	Jeżeli niezerowych zwraca Requery można wywołać ponownie uruchomić kwerendę rekordów.
CRecordset::CanScroll	Zwraca wartość niezerową, jeśli można przewijać rekordy.
CRecordset::CanTransact	Zwraca wartość niezerową, jeśli źródło danych obsługuje transakcje.
CRecordset::CanUpdate	Zwraca wartość niezerową, zaktualizowaniu rekordów (można dodać, zaktualizować lub usunąć rekordy).
CRecordset::CheckRowsetError	Nazywane obsługi błędów generowanych podczas pobierania rekordu.
CRecordset::Close	Zamknięcie zestawu rekordów i ODBC HSTMT skojarzony z nim.
CRecordset::Delete	Usuwa bieżący rekord w zestawie.Należy jawnie przewiń do innego rekordu po usunięciu.
CRecordset::DoBulkFieldExchange	Nazywane wymiany luzem wierszy danych ze źródła danych do zestawu rekordów.Implementuje luzem wymiany pola rekordu (RFX luzem).
CRecordset::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 rejestrować wymiany pól (RFX).
CRecordset::Edit	Przygotowuje się do zmian w bieżącym rekordzie.Wywołanie Update do wykonania do edycji.
CRecordset::FlushResultSet	Zwraca wartość niezerową, jeśli inny wynik ustawić pobierane podczas korzystania z wstępnie zdefiniowanej kwerendy.
CRecordset::GetBookmark	Przypisuje wartość zakładki rekordu do parametru obiektu.
CRecordset::GetDefaultConnect	Nazywane uzyskać domyślny ciąg połączenia.
CRecordset::GetDefaultSQL	Nazywane uzyskać domyślny ciąg SQL do wykonania.
CRecordset::GetFieldValue	Zwraca wartość pola w zestawie rekordów.
CRecordset::GetODBCFieldCount	Zwraca liczbę pól w zestawie rekordów.
CRecordset::GetODBCFieldInfo	Zwraca określonych rodzajów informacji dotyczących pól w zestawie rekordów.
CRecordset::GetRecordCount	Zwraca liczbę rekordów w zestawie rekordów.
CRecordset::GetRowsetSize	Zwraca liczbę rekordów, które chcesz pobrać podczas pojedynczego pobrania.
CRecordset::GetRowsFetched	Zwraca wartość rzeczywista liczba wierszy pobrane podczas pobierania.
CRecordset::GetRowStatus	Zwraca stan wiersza pobrania.
CRecordset::GetSQL	Pobiera ciąg SQL używany do wybierania rekordów dla zestawu rekordów.
CRecordset::GetStatus	Pobiera stan rekordów: indeks bieżącego rekordu i czy zostały uzyskane końcowe liczbę rekordów.
CRecordset::GetTableName	Pobiera nazwę tabeli, na którym oparty jest zestaw rekordów.
CRecordset::IsBOF	Zwraca wartość niezerową, jeśli zestaw rekordów ma został umieszczony przed pierwszego rekordu.Brak bieżącego rekordu.
CRecordset::IsDeleted	Zwraca wartość niezerową, jeśli zestaw rekordów jest umieszczony w usuniętym rekordzie.
CRecordset::IsEOF	Zwraca wartość niezerową, jeśli zestaw rekordów ma został umieszczony po ostatnim rekordzie.Brak bieżącego rekordu.
CRecordset::IsFieldDirty	Zwraca wartość niezerową, jeśli zmienił określonego pola w bieżącym rekordzie.
CRecordset::IsFieldNull	Zwraca wartość niezerową, jeśli jest null określonego pola w bieżącym rekordzie (nie ma wartości).
CRecordset::IsFieldNullable	Zwraca wartość niezerową, jeśli określonego pola w bieżącym rekordzie, można ustawić na wartość null (wartość nie posiadający).
CRecordset::IsOpen	Jeżeli niezerowych zwraca Open została wywołana wcześniej.
CRecordset::Move	Pozycji zestawu rekordów w określonej liczby rekordów z bieżącego rekordu w dowolnym kierunku.
CRecordset::MoveFirst	Pozycje bieżącego rekordu na pierwszy rekord w zestawie rekordów.Test IsBOF pierwszego.
CRecordset::MoveLast	Pozycje bieżącego rekordu ostatniego rekordu lub ostatnich wierszy.Test IsEOF pierwszego.
CRecordset::MoveNext	Pozycje bieżącego rekordu w następnym rekordzie lub na następnej wierszy.Test IsEOF pierwszego.
CRecordset::MovePrev	Pozycje bieżącego rekordu w poprzednim rekordzie lub na poprzednich wierszy.Test IsBOF pierwszego.
CRecordset::OnSetOptions	O nazwie ustawić opcje (używany na wybór) dla instrukcję ODBC.
CRecordset::OnSetUpdateOptions	Wywołana, aby ustawić opcje (używany na aktualizację) instrukcję ODBC.
CRecordset::Open	Otwiera zestaw rekordów przez pobieranie tabeli lub wykonywanie kwerendy, która reprezentuje zestaw rekordów.
CRecordset::RefreshRowset	Odświeża dane i stan określony wiersze.
CRecordset::Requery	Uruchamia kwerendę rekordów ponownie, aby odświeżyć zaznaczone rekordy.
CRecordset::SetAbsolutePosition	Pozycje zestaw rekordów z rekordem odpowiadającym określony numer rekordu.
CRecordset::SetBookmark	Pozycje zestawu rekordów do rekordu określony zakładką.
CRecordset::SetFieldDirty	Oznaczenie określonego pola w bieżącym rekordzie, jako zmieniony.
CRecordset::SetFieldNull	Ustawia wartość określonego pola w bieżącym rekordzie NULL (nie wartości o).
CRecordset::SetLockingMode	Ustawia tryb blokowania blokowania "pesymistycznego" lub "optymistyczne" blokowania (domyślnie).Określa sposób blokowania rekordów aktualizacji.
CRecordset::SetParamNull	Ustawia określony parametr null (nie wartości o).
CRecordset::SetRowsetCursorPosition	Umieszczenie kursora z określonego wiersza w zestawie wierszy.
CRecordset::SetRowsetSize	Określa liczbę rekordów, które chcesz pobrać podczas pobierania.
CRecordset::Update	Kończy AddNew lub Edit operacji przez zapisanie nowej lub edytowanej danych w źródle danych.

Publiczne danych członków

Nazwa	Opis
CRecordset::m_hstmt	Zawiera dojścia instrukcji ODBC dla zestawu rekordów.Type HSTMT.
CRecordset::m_nFields	Zawiera numer pola danych członków zestawu rekordów.Type UINT.
CRecordset::m_nParams	Zawiera liczbę członków danych parametru w zestawie rekordów.Type UINT.
CRecordset::m_pDatabase	Zawiera wskaźnik do CDatabase obiektu, przez który zestaw rekordów jest podłączony do źródła danych.
CRecordset::m_strFilter	Zawiera CString , który określa język SQL (Structured Query) WHERE klauzuli.Używany jako filtr, aby wybrać tylko te rekordy, które spełniają określone kryteria.
CRecordset::m_strSort	Zawiera CString , który określa SQL ORDER BY klauzuli.Służy do kontrolowania sposobu sortowania rekordów.

Uwagi

Znane jako "zestawy rekordów," CRecordset obiekty są zazwyczaj używane w dwóch formach: zestawy dynamiczne i migawki.Dynamiczny synchronizowany z aktualizacji danych wprowadzonych przez innych użytkowników.Migawki jest statyczny widok danych.Każdy formularz reprezentuje zestaw rekordów, ustalone w momencie otwierania zestawu rekordów, ale podczas przewijania do rekordu w dynamiczny odzwierciedla zmiany dokonane później w rekordzie przez innych użytkowników lub przez inne zestawy rekordów w aplikacji.

[!UWAGA]

Jeśli pracujesz z klas obiektów DAO (Data Access) zamiast klasy Open Database Connectivity (ODBC), należy użyć klasy CDaoRecordset zamiast.Aby uzyskać więcej informacji, zobacz artykuł Omówienie: bazy danych Programowanie.

Aby pracować z rodzaju albo zestaw rekordów, zazwyczaj czerpią klasy specyficzne dla aplikacji rekordów z CRecordset.Zestawy rekordów wybierz rekordy ze źródła danych i można następnie:

Przewiń rekordy.
Aktualizacja rekordów i określ tryb blokowania.
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.

Aby użyć klasy, otwórz bazę danych i konstruowanie obiektu recordset, przekazując wskaźnik do konstruktora your CDatabase obiektu.Następnie, wywoływać w zestawie rekordów Otwórz funkcji składowej, gdzie można określić, czy obiekt jest pobierany lub migawki.Wywołanie Otwórz wybiera danych ze źródła danych.Po otwarciu obiektu recordset, należy użyć jego funkcji i danych członków Członkowskie przewiń rekordy i operują na nich.Dostępne operacje zależy, czy obiekt jest pobierany lub migawki, czy jest aktualizowalna lub tylko do odczytu (zależy to możliwości Open Database Connectivity (ODBC) źródła danych), oraz czy wprowadziły pobieranie wiersza luzem.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.

W pochodnych CRecordset klasy, rejestrować wymiany pól (RFX) lub wymiany pola rekordu luzem (RFX luzem) jest używany do obsługi odczytywania i aktualizowania pola rekordu.

Więcej informacji o zestawy rekordów i rekord wymiany pól, zobacz artykuły Omówienie: bazy danych Programowanie, Zestaw rekordów (ODBC), rekordów: pobieranie rekordów luzem (ODBC), i Exchange pola rekordu (RFX).Aby skupić się na zestawy dynamiczne i migawek, zobacz artykuły dynamicznego i migawki.