Třída CRecordset

Článek
06/10/2015

Představuje sadu záznamů ze zdroje dat vybrána.

class CRecordset : public CObject

Členy

Veřejné konstruktory

Název	Description
CRecordset::CRecordset	Konstrukce CRecordset objektu.Konstruktor, který volá tento musí poskytnout odvozené třídy.

Veřejné metody

Název	Description
CRecordset::AddNew	Připraví pro přidání nového záznamu.Volání Update dokončete přidání.
CRecordset::CanAppend	Nenulová hodnota, pokud lze přidat nové záznamy do záznamů prostřednictvím vrátí AddNew členské funkce.
CRecordset::CanBookmark	Vrátí sadu záznamů podporuje záložky nenulová.
CRecordset::Cancel	Zruší asynchronní operace nebo druhý podproces procesu.
CRecordset::CancelUpdate	Zruší všechny čekající aktualizace požaduje AddNew nebo Edit operace.
CRecordset::CanRestart	Vrátí nenulovou Pokud Requery lze volat znovu spustit dotaz v sadě záznamů.
CRecordset::CanScroll	Vrátí nenulová posouvání v záznamech.
CRecordset::CanTransact	Vrátí nenulová hodnota, pokud zdroj dat podporuje transakce.
CRecordset::CanUpdate	Vrátí nenulová hodnota, pokud je možné aktualizovat sadu záznamů (lze přidat, aktualizaci nebo odstranění záznamů).
CRecordset::CheckRowsetError	Nazývá zpracování chyb během načítání záznamů.
CRecordset::Close	Ukončí sadu záznamů a ODBC HSTMT s ním spojené.
CRecordset::Delete	Odstraní aktuální záznam ze záznamů.Přejít na jiný záznam musí výslovně po odstranění.
CRecordset::DoBulkFieldExchange	Nazývá výměna řádků hromadných dat ze zdroje dat sady záznamů.Implementuje hromadně pole záznamu exchange (hromadné RFX).
CRecordset::DoFieldExchange	Nazývá výměna dat mezi členy pole dat sady záznamů a odpovídající záznam ve zdroji dat (v obou směrech).Záznam provádí výměnu (RFX).
CRecordset::Edit	Připraví změny aktuálního záznamu.Volání Update dokončit úpravy.
CRecordset::FlushResultSet	Nastavte načtena při použití předdefinovaného dotazu vrátí nenulovou, pokud existuje jiný výsledek.
CRecordset::GetBookmark	Přiřadí hodnota záložky záznamu parametr objektu.
CRecordset::GetDefaultConnect	Nazývá se získat výchozí připojovací řetězec.
CRecordset::GetDefaultSQL	Nazývá získat výchozí řetězec SQL spustit.
CRecordset::GetFieldValue	Vrátí hodnotu pole v sadě záznamů.
CRecordset::GetODBCFieldCount	Vrátí počet polí v sadě záznamů.
CRecordset::GetODBCFieldInfo	Vrátí určité informace o polích v sadě záznamů.
CRecordset::GetRecordCount	Vrátí počet záznamů v sadě záznamů.
CRecordset::GetRowsetSize	Vrátí počet záznamů, které chcete načíst během jediného fetch.
CRecordset::GetRowsFetched	Vrátí skutečný počet načtených během načítání řádků.
CRecordset::GetRowStatus	Po načtení vrátí stav řádku.
CRecordset::GetSQL	Načte řetězec SQL použité pro výběr záznamů pro sadu záznamů.
CRecordset::GetStatus	Získá stav záznamů: index aktuálního záznamu a zda byl získán konečný počet záznamů.
CRecordset::GetTableName	Získá název tabulky, na kterém je založen sadě záznamů.
CRecordset::IsBOF	Vrátí nenulová záznamů má byl umístěn před první záznam.Neexistuje žádný aktuální záznam.
CRecordset::IsDeleted	Vrátí nenulová hodnota, pokud sada záznamů je umístěn na odstraněný záznam.
CRecordset::IsEOF	Vrátí nenulová záznamů má byl umístěn za posledním záznamu.Neexistuje žádný aktuální záznam.
CRecordset::IsFieldDirty	Vrátí nenulovou změně určené pole v aktuálním záznamu.
CRecordset::IsFieldNull	Vrátí nenulovou zadané pole v aktuálním záznamu je null (nebyla zadána hodnota).
CRecordset::IsFieldNullable	Vrátí hodnotu zadaného pole v aktuálním záznamu lze nastavit na hodnotu null (žádná hodnota s) nenulová.
CRecordset::IsOpen	Vrátí nenulovou Pokud Open byla volána dříve.
CRecordset::Move	Pozice záznamů zadaný počet záznamů z aktuálního záznamu v obou směrech.
CRecordset::MoveFirst	Pozice aktuálního záznamu na první záznam v sadě záznamů.Test IsBOF první.
CRecordset::MoveLast	Pozice aktuálního záznamu na poslední záznam nebo na poslední sadu řádků.Test IsEOF první.
CRecordset::MoveNext	Pozice aktuálního záznamu na dalšího záznamu nebo další sady řádků.Test IsEOF první.
CRecordset::MovePrev	Pozice aktuálního záznamu na předchozí záznam nebo předchozích řádků.Test IsBOF první.
CRecordset::OnSetOptions	Pro zadaný příkaz ODBC se nazývá nastavení možností (používá na výběr).
CRecordset::OnSetUpdateOptions	Nazývá se nastavení možností (používané v aktualizaci) pro zadaný příkaz ODBC.
CRecordset::Open	Otevře sadu záznamů podle načtení tabulky nebo dotazu, který představuje sadu záznamů.
CRecordset::RefreshRowset	Aktualizuje data a stav zadané řádky.
CRecordset::Requery	Spustí dotaz sadu záznamů znovu a obnovit vybrané záznamy.
CRecordset::SetAbsolutePosition	Pozice záznamů na záznam odpovídající zadané číslo záznamu.
CRecordset::SetBookmark	Pozice záznamů na záznamu určené záložkou.
CRecordset::SetFieldDirty	Určené pole v aktuálním záznamu označí změněny.
CRecordset::SetFieldNull	Nastaví hodnotu určeného pole v aktuálním záznamu na hodnotu null (žádná hodnota s).
CRecordset::SetLockingMode	Nastaví režim uzamčení "optimistické" uzamčení (výchozí) nebo "pesimistické" uzamčení.Určuje, jak jsou záznamy uzamčeny aktualizace.
CRecordset::SetParamNull	Nastaví zadaný parametr null (žádná hodnota s).
CRecordset::SetRowsetCursorPosition	Kurzor je na zadaný řádek do řádků.
CRecordset::SetRowsetSize	Určuje počet záznamů, které chcete načíst během načítání.
CRecordset::Update	Provede AddNew nebo Edit operaci uložení dat nové nebo upravené na zdroji dat.

Veřejné datové členy

Název	Description
CRecordset::m_hstmt	Popisovač rozhraní ODBC příkazu Sada záznamů obsahuje.Type HSTMT.
CRecordset::m_nFields	Obsahuje číslo pole datové členy v sadě záznamů.Type UINT.
CRecordset::m_nParams	Obsahuje číslo parametru datové členy v sadě záznamů.Type UINT.
CRecordset::m_pDatabase	Obsahuje ukazatel CDatabase objektu, přes který záznamů je připojen ke zdroji dat.
CRecordset::m_strFilter	Obsahuje CString Určuje, že jazyka SQL (Structured Query) WHERE klauzule.Použít jako filtr, vyberte pouze ty záznamy, které splňují určitá kritéria.
CRecordset::m_strSort	Obsahuje CString SQL určující ORDER BY klauzule.Slouží k určení, jak jsou záznamy seřazeny.

Poznámky

Známé jako "sady záznamů," CRecordset objekty se obvykle používají ve dvou formách: dynamické sady a snímků.Je dynamická sada synchronizována s aktualizací dat provedené jinými uživateli.Snímek je statická zobrazení dat.Každý formulář představuje sadu záznamů stanovené v době, kdy je otevřena sada záznamů, ale při posouvání záznamu je dynamická sada odráží změny následně záznam, ostatní uživatelé nebo jiné sady záznamů v aplikaci.

[!POZNÁMKA]

Pokud pracujete s třídami objektů DAO (Data Access Objects) než tříd připojení ODBC (Open Database), použijte třídu CDaoRecordset místo.Další informace naleznete v článku Přehled: programování databáze.

Práce s buď typ sady záznamů, obvykle odvodit třídu aplikace záznamů z CRecordset .Sady záznamů vyberte záznamy ze zdroje dat a potom můžete:

Posouvání v záznamech.
Aktualizovat záznamy a určit režim uzamčení.
Filtrování záznamů omezit záznamy, které vybere z dostupných na zdroji dat.
Řazení záznamů.
Parametrizaci informace není známa až do spuštění přizpůsobit výběr záznamů.

Použití třídy, otevřete databázi a vytvoření objektu recordset, prochází konstruktor ukazatel na vaše CDatabase objektu.Zavolejte sadě záznamů otevřených členské funkce, kde můžete určit, zda je objekt je dynamická sada nebo snímek.Volání otevřených vyberete data ze zdroje dat.Po otevření objektu recordset pomocí členské funkce a data členů posouvání v záznamech a pracovat s nimi.Operace k dispozici závisí na tom, zda je objekt je dynamická sada nebo snímek, aktualizovat nebo jen pro čtení (závisí na schopnosti zdroj dat Open Database Connectivity (ODBC)), a zda jste implementovali načítání řádků hromadně.Aktualizovat záznamy, které mohou byly změněny nebo přidány od otevřených volání, volání objektu Requery členské funkce.Volání objektu Zavřít členské funkce a po dokončení jeho zničení objektu.

Odvozené v CRecordset třídy, zaznamenat výměnu (RFX) nebo hromadné pole záznamu exchange (hromadné RFX) se používá pro podporu čtení a aktualizace záznamů polí.

Další informace o výměnu sady záznamů a záznamů naleznete v článcích Přehled: programování databáze, Záznamů (ODBC), záznamů: načítání záznamů hromadné (ODBC), a Exchange pole v záznamu (RFX).Zaměření na dynamické sady a snímků naleznete v článcích Dynaset a snímek.