DFX_Text

Articolo
06/10/2015

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 della funzione.
szName
Il nome di una colonna di dati.
corrispondente
Il valore memorizzato nel membro dati - visualizzato il valore da trasferire. Per un trasferimento dal recordset nell'origine dati, il valore, di tipo CString, vengono forniti 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 questa dimensione a un valore abbastanza grande da impedire che vengano 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. Mentre l'altro è possibile AFX_DAO_DISABLE_FIELD_CACHE. Se si specifica questo valore, MFC non esegue controllare in questo campo. È necessario chiamare SetFieldDirty e SetFieldNull manualmente.

Nota

Controllare se i dati vengano 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 il 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 DFX collegate 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);
}