RFX_Text

void RFX_Text ( objet CFieldExchange * pFX, const char * szName, CStringamp ; valeur, int nMaxLength = 255, int nColumnType = SQL_V&ARCHAR, courtnScale = 0 );

Paramètres

pFX

Pointeur vers un objet de classe objet 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 d'un objet CFieldExchange peut spécifier, consultez l'article Record Field Exchange : fonctionnement de RFX dans le Guide du programmeur Visual C++.

szName

Le nom d'une colonne de données.

valeur

La valeur stockée dans le membre de données indiqué — la valeur devant être transférés. Pour un transfert du jeu d'enregistrements de la source de données, la valeur, de type CString, est tirée de la donnée membre spécifiée. Pour un transfert de source de données pour le jeu d'enregistrements, la valeur est stockée dans le membre de données spécifié.

nMaxLength

La quantité maximale autorisée la longueur de la chaîne ou le tableau transféré. La valeur par défaut de nMaxLength est 255. Les valeurs légales sont 1 à INT_MAX. Le cadre répartit cette quantité d'espace pour les données. Pour la meilleure performance, transmettez une valeur suffisamment grande pour accueillir le plus grand élément de données que vous attendez.

nColumnType

Utilisé principalement pour les paramètres. Un entier indiquant le type de données du paramètre. Le type est un type de données ODBC de la forme SQL_XXX.

nScale

Spécifie l'échelle de valeurs de type ODBC SQL_DECIMAL ou SQL_NUMERIC. nScale n'est utile que lors de la définition des valeurs de paramètre. Pour plus d'informations, consultez la rubrique « Précision, échelle, longueur et taille d'affichage » de l'annexe d de la référence du programmeur ODBC SDK.

Remarques

La fonction RFX_Text transfère les données de CString entre les données membres de champ d'un objet CRecordset et les colonnes d'un enregistrement dans la source de données de type ODBC SQL_LONGVARCHAR, SQL_CHAR, SQL_VARCHAR, SQL_DECIMALou SQL_NUMERIC. Données dans la source de tous ces types de données sont mappées vers et à partir de CString dans le jeu d'enregistrements.

Exemple

Cet exemple montre plusieurs appels RFX_Text. Notez également les deux appels à CFieldExchange::SetFieldType. ClassWizard écrit normalement le deuxième appel à SetFieldType et ses associés les appels RFX. Vous devez écrire le premier appel et les appels RFX. Il est recommandé que vous mettez tous les éléments de paramètre avant le "/ / {{AFX_FIELD_MAP" commentaire. Vous devez mettre les paramètres à l'extérieur les commentaires.

//Example de RFX_Text
VOID CSections::DoFieldExchange (objet CFieldExchange * pFX)
{
   pFX-gt ;SetFieldType(CFieldExchange::inputParam) ;
   RFX_Text (pFX, « Nom », m_strNameParam) ;

//{{AFX_FIELD_MAP(CSections)
   pFX - > SetFieldType(CFieldExchange::outputColumn) ;
   RFX_Text (pFX, « CourseID », m_strCourseID) ;
   RFX_Text (pFX, « InstructorID », m_strInstructorID) ;
   RFX_Int (pFX, « RoomNo », m_nRoomNo) ;
   RFX_Text (pFX, « Annexe », m_strSchedule) ;
   RFX_Int (pFX, « SectionNo », m_nSectionNo) ;
   RFX_Single (pFX, « LabFee », m_flLabFee) ;
   //}}AFX_FIELD_MAP
}

Voir aussi  ;RFX_Bool, RFX_Long, RFX_Int, RFX_Single, RFX_Double, RFX_Date, RFX_Byte, RFX_Binary, RFX_LongBinary, CFieldExchange::SetFieldType

Index