Jeu d'enregistrements : architecture (ODBC)

Article
08/21/2008

Mise à jour : novembre 2007

Cette rubrique s'applique aux classes ODBC MFC.

Cette rubrique décrit les membres de données qui composent l'architecture d'un objet recordset :

Membres de données de type champ
Membres de données de type paramètre
Utilisation des membres de données m_nFields et m_nParams

Remarque :
Cette rubrique s'applique aux objets dérivés de CRecordset dans lesquels l'extraction de lignes en bloc n'a pas été implémentée. Si l'extraction de lignes en bloc est implémentée, l'architecture est similaire. Pour plus d'informations sur les différences, consultez Jeu d'enregistrements : extraction globale d'enregistrements (ODBC).

Exemple de classe

Lorsque vous utilisez l'Assistant Consommateur ODBC MFC à partir de l'Assistant Ajouter une classe et déclarez une classe de jeu d'enregistrements dérivée de CRecordset, la classe obtenue possède la structure générale illustrée par l'exemple de classe suivant :

class CCourse : public CRecordset
{
public:
   CCourse(CDatabase* pDatabase = NULL);
   ...
   CString m_strCourseID;
   CString m_strCourseTitle;
   CString m_strIDParam;
};

En début de classe, l'Assistant écrit un ensemble de membres de données de type champ. Lorsque vous créez la classe, vous devez indiquer un ou plusieurs membres de données de type champ. Si la classe est paramétrée, à l'image de l'exemple de classe (avec le membre de données m_strIDParam), vous devez ajouter manuellement les membres de données de type paramètre. L'Assistant ne prend pas en charge l'ajout de paramètres à une classe.

Membres de données de type champ

Les membres les plus importants de votre classe de jeu d'enregistrements sont les membres des données de champ. Pour chaque colonne que vous sélectionnez à partir de la source des données, la classe contient un membre de données du type de données approprié pour cette colonne. Par exemple, l'exemple de classe illustré en début de cette rubrique possède deux membres de données de type champ, les deux de type CString, appelés m_strCourseID et m_strCourseTitle.

Lorsque le jeu d'enregistrements sélectionne une série d'enregistrements, la structure lie automatiquement les colonnes de l'enregistrement actuel (après l'appel Open, le premier enregistrement est considéré comme l'enregistrement actuel) aux données membres de champ de l'objet. Autrement dit, l'infrastructure utilise le membre approprié de données de type champ comme tampon, dans lequel il stocke le contenu de la colonne d'un enregistrement.

Quand l'utilisateur passe à un nouvel enregistrement, l'infrastructure utilise les membres des données de champ pour représenter l'enregistrement actuel. L'infrastructure actualise les membres des données de champ en remplaçant les valeurs de l'enregistrement précédent. Les membres des données de champ sont également utilisés pour la mise à jour de l'enregistrement actuel ou pour l'ajout de nouveaux enregistrements. Dans le cadre du processus de mise à jour d'un enregistrement, vous indiquez les valeurs de mise à jour en les assignant directement au(x) membre(s) de données de type champ approprié(s).

Membres de données de type paramètre

Si la classe est paramétrée, elle comporte un ou plusieurs données membres de paramétrage. Une classe paramétrée vous permet de baser une requête de jeu d'enregistrements sur des informations obtenues ou calculées au moment de l'exécution.

En général, le paramètre vous aide à affiner la sélection, comme dans l'exemple suivant : Fondé sur l'exemple de classe du début de cette rubrique, l'objet recordset pourrait exécuter l'instruction SQL suivante :

SELECT CourseID, CourseTitle FROM Course WHERE CourseID = ?

Le « ? » constitue un emplacement réservé pour la valeur de paramètre fournie à l'exécution. Lorsque vous construisez le jeu d'enregistrements et définissez sa donnée membre m_strIDParam sur MATH101, l'instruction SQL effective pour le jeu d'enregistrements devient :

SELECT CourseID, CourseTitle FROM Course WHERE CourseID = MATH101

En définissant des membres des données de paramétrage, vous indiquez à l'infrastructure les paramètres utilisés dans la chaîne SQL. L'infrastructure lie le paramètre, ce qui permet à ODBC de savoir où doivent être recherchées les valeurs qui viendront se substituer aux emplacements réservés. Dans cet exemple, le jeu d'enregistrements qui en résulte contient uniquement l'enregistrement provenant de la table Course avec une colonne CourseID dont la valeur est MATH101. Toutes les colonnes spécifiées de cet enregistrement sont sélectionnées. Vous pouvez indiquer autant de paramètres (et d'emplacements réservés) que vous le souhaitez.

Remarque :
MFC ne fait rien lui-même de ces paramètres (il n'effectue pas, notamment, de substitution de texte). À la place, MFC indique à ODBC où rechercher le paramètre ; ODBC récupère les données et effectue l'opération de paramétrage nécessaire.

Remarque :
L'ordre des paramètres est important. Pour plus d'informations à ce sujet et sur les paramètres, consultez Jeu d'enregistrements : paramétrage d'un jeu d'enregistrements (ODBC).

Utilisation de m_nFields et de m_nParams

Quand un Assistant écrit un constructeur pour votre classe, il initialise aussi le membre de données m_nFields, qui contient le nombre de membres de données de type champ dans la classe. Si vous ajoutez des paramètres à votre classe, vous devez également procéder à l'initialisation du membre de données m_nParams, qui contient le nombre de membres de données de type paramètre. L'infrastructure utilise ces valeurs pour travailler avec les données membres.

Pour plus d'informations et d'exemples, consultez Record Field Exchange : utilisation de RFX.

Voir aussi

Concepts

Jeu d'enregistrements (ODBC)

Jeu d'enregistrements : déclaration de la classe d'une table (ODBC)

Record Field Exchange (RFX)

Partager via