DFX_Text

Artikel
06/10/2015

Übergangs- CString Daten zwischen den Felddatenmembern eines CDaoRecordset-Objekts und Spalten eines Datensatzes auf der Datenquelle.

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

Parameter

pFX
Ein Zeiger auf ein Objekt der Klasse CDaoFieldExchange. Dieses Objekt enthält Informationen, um den Kontext für jeden Aufruf der Funktion.
szName
Der Name einer Datenspalte.
Wert
Der Wert gespeichert im angegebenen Datenmember - der zu übertragenden Wert. Eine Übertragung vom Recordset zu Datenquelle, wird der Wert, des Typs CString, im angegebenen Datenmember angewendet. Eine Übertragung von Datenquelle zu Recordset, wird der Wert im angegebenen Datenmember gespeichert.
nPreAllocSize
Das Framework teilt diesen Arbeitsspeicher zu. Wenn die Daten größer sind, ist das Framework zugeordnet hat mehr Leerzeichen nach Bedarf. Zur Leistungsverbesserung legen Sie diese Größe auf einen Wert fest, der ausreicht, um die Neuzuordnungen zu verhindern groß ist.
dwBindOptions
Eine Option, die Sie Mechanismus doppelter Pufferung MFC zum Feststellen von Recordsetfeldern nutzen können, die geändert wurden. Der Standard, AFX_DAO_ENABLE_FIELD_CACHE, verwendet doppelte Pufferung. Der andere mögliche Wert ist AFX_DAO_DISABLE_FIELD_CACHE. Wenn Sie diesen Wert angeben, verfährt MFC keine Überprüfung auf dieses Feld. Sie müssen SetFieldDirty und SetFieldNull aufgerufen werden.

Hinweis

Sie können steuern, ob Daten das double sind, das standardmäßig gepuffert werden, indem sie CDaoRecordset::m_bCheckCacheForDirtyFields festlegen.

Hinweise

Daten werden zwischen Typ DAO_CHAR der DAO zugeordnet (oder, wenn das Symbol _UNICODE definiert wird, DAO_WCHAR) und den Typ CString im Recordset.

Beispiel

In diesem Beispiel wird DFX_Text mehrere Aufrufe. Begriff auch die beiden Aufrufe von CDaoFieldExchange::SetFieldType. Sie müssen den ersten Aufruf schreiben SetFieldType und dem Aufruf DFX. Der zweite Aufruf und seine zugeordneten DFX Aufrufe werden normalerweise vom Code-Assistenten geschrieben, der die Klasse generierte.

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