RFX_Text

Článek
03/04/2013

Převody CString dat mezi členy pole dat CRecordset objektu a sloupce záznam ve zdroji dat ODBC typu SQL_LONGVARCHAR, SQL_CHAR, SQL_VARCHAR, SQL_DECIMAL, nebo SQL_NUMERIC.

void RFX_Text(
   CFieldExchange* pFX,
   const char* szName,
   CString& value,
   int nMaxLength = 255,
   int nColumnType = SQL_VARCHAR,
   short nScale = 0 
);

Parametry

pFX
Ukazatel na objekt třídy CFieldExchange.Tento objekt obsahuje informace, které definují kontext pro volání funkce.Další informace o operacích CFieldExchange objekt můžete zadat, naleznete v článku Exchange pole záznamu: Jak funguje RFX.
szName
Název datového sloupce.
hodnota
Hodnota uložená v uvedených datový člen – hodnota má být převedeno.Pro přenos ze záznamů na hodnotu typu zdroje dat CString, je převzata z členů zadaná data.Pro převod ze zdroje dat do záznamů hodnota uložena v členských zadaná data.
nMaxLength
Maximální povolená délka řetězce nebo pole, které jsou převáděny.Výchozí hodnota nMaxLength je 255.Platné hodnoty jsou 1 INT_MAX.Rámci přidělí toto množství místa pro data.Nejlepší výkon předáte dostatečně velké pro uchování největší položky dat očekávané hodnoty.
nColumnType
Používá se především pro parametry.Celé číslo označující datový typ parametru.Typ je typ dat ODBC formuláře SQL_XXX.
nScale
Určuje měřítko pro hodnoty typu ODBC SQL_DECIMAL nebo SQL_NUMERIC.nScaleje užitečné pouze při nastavení hodnot parametrů.Další informace naleznete v tématu "Přesnost, měřítko, délka a velikost zobrazení" v dodatku d ODBC SDK Programmer's Reference.

Poznámky

Data ve zdroji dat všech těchto typů je namapován do a z CString v sadě záznamů.

Příklad

Tento příklad ukazuje několik volání na RFX_Text.Všimněte si také dva volání na CFieldExchange::SetFieldType.Pro parametry musí zapsat volání SetFieldType a jeho RFX volání.Kód průvodce obvykle píší volání výstupní sloupec a jeho přidružené volání RFX.

void CCustomer::DoFieldExchange(CFieldExchange* pFX)
{
   pFX->SetFieldType(CFieldExchange::outputColumn);
   // Macros such as RFX_Text() and RFX_Int() are dependent on the
   // type of the member variable, not the type of the field in the database.
   // ODBC will try to automatically convert the column value to the requested type
   RFX_Long(pFX, _T("[CustomerID]"), m_CustomerID);
   RFX_Text(pFX, _T("[ContactFirstName]"), m_ContactFirstName);
   RFX_Text(pFX, _T("[PostalCode]"), m_PostalCode);
   RFX_Text(pFX, _T("[L_Name]"), m_L_Name);
   RFX_Long(pFX, _T("[BillingID]"), m_BillingID);

   pFX->SetFieldType(CFieldExchange::inputParam);
   RFX_Text(pFX, _T("Param"), m_strParam);
}