RFX_Text

Article
03/04/2013

Données d' CString de transferts entre les données membres de champ d'un objet d' CRecordset et les colonnes d'un enregistrement dans la source de données de type ODBC SQL_LONGVARCHAR, SQL_CHAR, SQL_VARCHAR, SQL_DECIMAL, ou SQL_NUMERIC.

void RFX_Text(
   CFieldExchange* pFX,
   const char* szName,
   CString& value,
   int nMaxLength = 255,
   int nColumnType = SQL_VARCHAR,
   short nScale = 0 
);

Paramètres

pFX
Un pointeur vers un objet de classe CFieldExchange.Cet objet contient des informations pour définir le contexte pour chaque appel de la fonction.Pour plus d'informations sur les opérations qu'un objet d' CFieldExchange peut spécifier, consultez l'article Record field exchange : Comment le fonctions RFX.
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.
nMaxLength
La longueur maximale de la chaîne ou du tableau à transférer.La valeur par défaut de nMaxLength est 255.Les valeurs autorisé sont 1 à INT_MAX.l'infrastructure alloue cette quantité d'espace pour les données.Pour optimiser les performances, passez une valeur assez grand pour recevoir le plus grand élément de données attendues.
nColumnType
Essentiellement utilisé pour les paramètres.Un entier indiquant le type de données du paramètre.Le type est un type de données ODBC du formulaire SQL_XXX.
nScale
Spécifie l'échelle pour les valeurs de type SQL_DECIMAL ou SQL_NUMERICODBC.nScale est utile uniquement en définissant des valeurs de paramètre.Pour plus d'informations, consultez la rubrique « précision, l'échelle, la longueur, et taille d'affichage » dans l'annexe D ODBC SDK Programmer's Reference.

Notes

Les données dans la source de données de tous ces types est mappée à partir de CString dans le recordset.

Exemple

Cet exemple illustre plusieurs appels à RFX_Text.Noter également les deux appels à CFieldExchange::SetFieldType.Pour les paramètres vous devez écrire un appel à SetFieldType et son appel de fonction RFX.L'appel de colonne de sortie et ses appels associés RFX sont normalement écrits par un Assistant Code.

void CCustomer::DoFieldExchange(CFieldExchange* pFX)
{
   pFX->SetFieldType(CFieldExchange::outputColumn);
   // Macros such as RFX_Text() and RFX_Int() are dependent on the
   // type of the member variable, not the type of the field in the database.
   // ODBC will try to automatically convert the column value to the requested type
   RFX_Long(pFX, _T("[CustomerID]"), m_CustomerID);
   RFX_Text(pFX, _T("[ContactFirstName]"), m_ContactFirstName);
   RFX_Text(pFX, _T("[PostalCode]"), m_PostalCode);
   RFX_Text(pFX, _T("[L_Name]"), m_L_Name);
   RFX_Long(pFX, _T("[BillingID]"), m_BillingID);

   pFX->SetFieldType(CFieldExchange::inputParam);
   RFX_Text(pFX, _T("Param"), m_strParam);
}