DFX_Text

Article
03/04/2013

Données d' CString de transferts entre les données membres de champ d'un objet de CDaoRecordset et les colonnes d'un enregistrement dans la source de données.

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

Paramètres

pFX
Un pointeur vers un objet de classe CDaoFieldExchange.Cet objet contient des informations pour définir le contexte pour chaque appel de la fonction.
szName
Le nom d'une colonne de données.
correspondante
La valeur signalée dans le membre de données désignée — la valeur à transférer.Pour un transfert du recordset vers la source de données, la valeur, le type CString, est prise de la donnée membre spécifiée.Pour une migration de source de données vers le recordset, la valeur est stockée dans le membre de données spécifiée.
nPreAllocSize
l'infrastructure préaffecte cette quantité de mémoire.Si vos données sont plus grande, l'infrastructure allouée davantage d'espace que nécessaire.Pour de meilleures performances, définissez cette taille à une valeur suffisamment grande pour empêcher les réaffectations.
dwBindOptions
Une option qui vous permet de tirer parti du mécanisme de le mécanisme de double tampon MFC pour détecter les champs du recordset qui ont changé.La valeur par défaut, AFX_DAO_ENABLE_FIELD_CACHE, utilise le mécanisme de double tampon.l'autre valeur possible est AFX_DAO_DISABLE_FIELD_CACHE.Si vous spécifiez cette valeur, MFC ne fait aucun contrôle sur ce champ.Vous devez appeler SetFieldDirty et SetFieldNull vous-même.

[!REMARQUE]

Vous pouvez contrôler si les données sont double tampon par défaut en définissant CDaoRecordset::m_bCheckCacheForDirtyFields.

Notes

Les données sont mappés entre le type DAO_CHAR dans DAO (ou, si le symbole _UNICODE est défini, DAO_WCHAR) et le type CString dans le recordset.

Exemple

Cet exemple illustre plusieurs appels à DFX_Text.Noter également les deux appels à CDaoFieldExchange::SetFieldType.Vous devez écrire le premier appel à SetFieldType et son appel de DFX .Le deuxième appel et ses appels associés de DFX sont normalement entrés par l'Assistant Code qui a généré 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);
}