DFX_Text

Článek
06/10/2015

Převody CString data mezi poli datových členů sady CDaoRecordset a sloupce záznamu ve zdroji dat objektu.

void AFXAPI DFX_Text( 
   CDaoFieldExchange* pFX, 
   LPCTSTR szName, 
   CString& value, 
   int nPreAllocSize = AFX_DAO_TEXT_DEFAULT_SIZE,
   DWORD dwBindOptions = AFX_DAO_ENABLE_FIELD_CACHE  
);

Parametry

pFX
Ukazatel na objekt třídy CDaoFieldExchange.Tento objekt obsahuje informace, které definují kontext pro každé volání funkce.
szName
Název datového sloupce.
hodnota
Hodnota uložená v určeném datovém členu – hodnota, kterou chcete převést.Pro přenos ze sady záznamů do zdroje dat, je hodnota typu CString, je převzata ze zadaného datového člena.Převod ze zdroje dat do sady záznamů hodnota je uložena v členu zadaná data.
nPreAllocSize
Rámci preallocates toto množství paměti.Pokud vaše data jsou větší, bude rámci přidělení více místa podle potřeby.Pro lepší výkon nastavena na hodnotu, která je dostatečně velký, aby se zabránilo přerozdělení této velikosti.
dwBindOptions
Možnost, která umožňuje využít MFC dvojité vyrovnávací mechanismus pro zjišťování polím sady záznamů, které byly změněny.Výchozí, AFX_DAO_ENABLE_FIELD_CACHE, používá dvojité ukládání do vyrovnávací paměti.S možnou hodnotou je AFX_DAO_DISABLE_FIELD_CACHE.Pokud chcete zadat tuto hodnotu, MFC nemá žádná kontrola na tomto poli.Musíte zavolat SetFieldDirty a SetFieldNull sami.

[!POZNÁMKA]

Můžete určit, zda data jsou dvojité vyrovnávací paměti ve výchozím nastavením CDaoRecordset::m_bCheckCacheForDirtyFields.

Poznámky

Data namapována mezi typ DAO_CHAR v DAO (nebo v případě symbol _UNICODE je definována, DAO_WCHAR) a typ CString v sadě záznamů.

Příklad

Tento příklad ukazuje několik volání DFX_Text.Všimněte si také dvě volání na CDaoFieldExchange::SetFieldType.Musíte napsat první volání SetFieldType a jeho DFX volání.Druhé volání a jeho přidružený DFX volání se normálně zapisují pomocí Průvodce kód generovaný třídy.

void CCustSet::DoFieldExchange(CDaoFieldExchange* pFX)
{
   pFX->SetFieldType(CDaoFieldExchange::param);
   DFX_Text(pFX, _T("Param"), m_strParam);
   pFX->SetFieldType(CDaoFieldExchange::outputColumn);
   DFX_Short(pFX, _T("EmployeeID"), m_EmployeeID);
   DFX_Text(pFX, _T("LastName"), m_LastName);
   DFX_Short(pFX, _T("Age"), m_Age);
   DFX_DateTime(pFX, _T("hire_date"), m_hire_date);
   DFX_DateTime(pFX, _T("termination_date"), m_termination_date);

   CDaoRecordset::DoFieldExchange(pFX);
}