DFX_Text

Articolo
03/05/2013

Dati di CString di trasferimenti tra i membri dati di campo di un oggetto di CDaoRecordset e le colonne di un record nell'origine dati.

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

Parametri

pFX
Un puntatore a un oggetto di classe CDaoFieldExchange.Questo oggetto contiene le informazioni per definire il contesto per ogni chiamata di funzione.
szName
Il nome di una colonna di dati.
corrispondente
Il valore memorizzato nel membro dati visualizzato al valore da trasferire.Per un trasferimento dal recordset nell'origine dati, il valore, di tipo CString, viene ricavato dal membro dati specificato.Per un trasferimento dall'origine dati del recordset, il valore verrà memorizzato nel membro dati specificato.
nPreAllocSize
Il framework preassegna questa quantità di memoria.Se i dati sono più grandi, il framework ha allocato più spazio in base alle necessità.Per prestazioni ottimali, impostare la dimensione su un valore abbastanza grande da impedire gli riallocazioni.
dwBindOptions
Un'opzione che consente di sfruttare il meccanismo del doppio buffer di MFC per rilevare i campi del recordset sia stato modificato.L'impostazione predefinita, AFX_DAO_ENABLE_FIELD_CACHE, viene utilizzato il doppio buffer.Gli altri valori possibili è AFX_DAO_DISABLE_FIELD_CACHE.Se si specifica questo valore, MFC non esegue controllare in questo campo.È necessario chiamare SetFieldDirty e SetFieldNull manualmente.

[!NOTA]

È possibile controllare se i dati siano doppio buffering per impostazione predefinita impostando CDaoRecordset::m_bCheckCacheForDirtyFields.

Note

I dati vengono mappati tra tipo DAO_CHAR in DAO (o, se il simbolo _UNICODE è definito, DAO_WCHAR) e tipo CString nel recordset.

Esempio

Questo esempio mostra diverse chiamate a DFX_Text.Avviso anche le due chiamate a CDaoFieldExchange::SetFieldType.È necessario scrivere la prima chiamata a SetFieldType e la chiamata di DFX .La seconda chiamata e le relative chiamate di e DFX vengono generalmente scritte dalla creazione guidata codice che ha generato la classe.

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);
}