Sdílet prostřednictvím

Výměna polí záznamu: Použití funkcí RFX

  • Článek

Toto téma vysvětluje, jak používat volání funkce RFX, která tvoří tělo přepsání DoFieldExchange .

Poznámka:

Toto téma se týká tříd odvozených z CRecordset , ve kterých hromadné načítání řádků nebylo implementováno. Pokud používáte hromadné načítání řádků, je implementována výměna polí hromadného záznamu (Bulk RFX). Hromadný formát RFX je podobný formátu RFX. Informace o rozdílech najdete v tématu Sada záznamů: Hromadné načítání záznamů (ODBC).

Globální funkce RFX vyměňují data mezi sloupci ve zdroji dat a datovými členy polí v sadě záznamů. Volání funkce RFX napíšete do členské funkce DoFieldExchange sady záznamů. Toto téma stručně popisuje funkce a zobrazuje datové typy, pro které jsou dostupné funkce RFX. Technická poznámka 43 popisuje, jak psát vlastní funkce RFX pro další datové typy.

Syntaxe funkce RFX

Každá funkce RFX přebírá tři parametry (a některé mají volitelný čtvrtý nebo pátý parametr):

  • Ukazatel na objekt CFieldExchange . Jednoduše předáte pFX ukazatel DoFieldExchange.

  • Název sloupce, který se zobrazí ve zdroji dat.

  • Název odpovídajícího datového členu pole nebo datového člena parametru ve třídě sady záznamů.

  • (Volitelné) V některých funkcích se přenese maximální délka řetězce nebo pole. Výchozí hodnota je 255 bajtů, ale můžete ji chtít změnit. Maximální velikost je založena na maximální velikosti objektu CString – INT_MAX (2 147 483 647) bajtů – ale pravděpodobně se setkáte s limity ovladačů před danou velikostí.

  • (Volitelné) RFX_Text Ve funkci někdy použijete pátý parametr k určení datového typu sloupce.

Další informace naleznete v dokumentech RFX v části Makra a globální objekty v referenčních informacích k knihovně tříd. Příklad, kdy byste mohli použít speciální parametry, naleznete v tématu Sada záznamů: Získání SUMs a další agregační výsledky (ODBC).

Datové typy RFX

Knihovna tříd poskytuje funkce RFX pro přenos mnoha různých datových typů mezi zdrojem dat a sadami záznamů. Následující seznam shrnuje funkce RFX podle datového typu. V případech, kdy musíte napsat vlastní volání funkce RFX, vyberte z těchto funkcí podle datového typu.

Function Datový typ
RFX_Bool BOOL
RFX_Byte BAJT
RFX_Binary CByteArray
RFX_Double double
RFX_Single float
RFX_Int int
RFX_Long long
RFX_LongBinary CLongBinary
RFX_Text CString
RFX_Date CTime

Další informace naleznete v dokumentaci k funkci RFX v části Makra a globální hodnoty v referenční dokumentaci knihovny tříd. Informace o mapování datových typů C++ na datové typy SQL naleznete v tabulce ANSI SQL Datové typy mapované na datové typy C++ v SQL: SQL a C++ Datové typy (ODBC).

Viz také

Výměna polí záznamu (Record Field Exchange – RFX)
Výměna polí záznamu: Jak funkce RFX pracuje
Sada záznamů: Parametrizace sady záznamů (ODBC)
Sada záznamů: Dynamické vazby datových sloupců (ODBC)
CRecordset – třída
CFieldExchange – třída