DFX_Text

Článek
03/04/2013

Převody CString dat mezi členy pole dat CDaoRecordset objektu a sloupce záznam ve zdroji dat.

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 volání funkce.
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.
nPreAllocSize
Preallocates rámci tohoto množství paměti.Pokud data větší, bude rámci přidělení více místa podle potřeby.Pro lepší výkon nastaven na hodnotu, která je dostatečně velký, aby se zabránilo přerozdělení této velikosti.
dwBindOptions
Tato možnost umožňuje využívat jeho MFC dvojité vyrovnávací paměti mechanismus zjišťování záznamů pole, které změnily.Výchozí nastavení, AFX_DAO_ENABLE_FIELD_CACHE, používá dvojité ukládání do vyrovnávací paměti.Možná hodnota je AFX_DAO_DISABLE_FIELD_CACHE.Pokud určíte tuto hodnotu, MFC nemá žádnou kontrolu tohoto pole.Musíte zavolat SetFieldDirty a SetFieldNull sami.

[!POZNÁMKA]

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

Poznámky

Data je mapována mezi DAO_CHAR v DAO (nebo pokud symbol _UNICODE je definován DAO_WCHAR) a typ CString v sadě záznamů.

Příklad

Tento příklad ukazuje několik volání na DFX_Text.Všimněte si také dva volání na CDaoFieldExchange::SetFieldType.První volání musí zapsat SetFieldType a jeho DFX volání.Druhé volání a jeho přidružený DFX volání se normálně zapisují průvodcem 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);
}