Partager via


RFX_Text

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

Configuration requise

Header: afxdb.h

Voir aussi

Référence

RFX_Bool

RFX_Long

RFX_Int

RFX_Single

RFX_Double

RFX_Date

RFX_Byte

RFX_Binary

RFX_LongBinary

CFieldExchange::SetFieldType

Concepts

Macro MFC et Globals