Recordset : filtrage d'enregistrements (ODBC)
Cette rubrique s'applique aux classes ODBC MFC.
La présente rubrique explique comment filtrer un recordset afin qu'il ne sélectionne qu'un sous-ensemble particulier au sein des enregistrements disponibles. Par exemple, vous pourriez vouloir ne sélectionner que les sections classe d'un cours donné, comme MATH101. Un filtre est une condition de recherche définie par le contenu d'une clause SQL WHERE. Quand l'infrastructure l'ajoute à l'instruction SQL du recordset, la clause WHERE limite la sélection.
Vous devez établir un filtre d'objet recordset après avoir construit l'objet mais avant d'appeler sa fonction membre Open (ou la fonction membre Requery d'un objet recordset existant dont la fonction membre Open a été appelée préalablement).
Pour définir le filtre d'un objet recordset
Construisez un nouvel objet recordset (ou préparez l'appel de Requery dans le cas d'un objet existant).
Définissez la valeur du membre de données m_strFilter de l'objet.
Le filtre est une chaîne terminée par le caractère NULL qui contient le contenu de la clause SQL WHERE mais pas le mot clé WHERE. Par exemple, utilisez
m_pSet->m_strFilter = "CourseID = 'MATH101'";not
m_pSet->m_strFilter = "WHERE CourseID = 'MATH101'";Notes
La chaîne « MATH101 » est encadrée ci-dessus par des guillemets simples.Dans la spécification SQL ODBC, les guillemets simples sont utilisés pour identifier les littéraux de chaîne.Vérifiez dans la documentation de votre pilote ODBC les utilisations requises par le SGBD en matière de guillemets.Ce point de syntaxe est également traité plus loin dans la présente rubrique.
Définissez les autres options nécessaires, comme l'ordre de tri, le mode de verrouillage ou les paramètres. Il peut être très utile de définir un paramètre. Pour plus d'informations sur le paramétrage d'un filtre, consultez Recordset : paramétrage d'un recordset (ODBC).
Appelez la fonction Open pour le nouvel objet (ou Requery pour un objet préalablement ouvert).
Conseil
L'utilisation de paramètres dans votre filtre constitue pratiquement la méthode la plus efficace pour récupérer des enregistrements.
Conseil
Les filtres de recordsets sont utiles pour joindre des tables ou utiliser des paramètres liés aux informations fournies ou calculées à l'exécution.
Le recordset ne sélectionne que les enregistrements qui satisfont aux critères de recherche que vous avez définis. Par exemple, pour définir le filtre sur les cours évoqué ci-dessus (en supposant que la variable strCourseID ait pour valeur « MATH101 »), écrivez le code suivant :
// Using the recordset pointed to by m_pSet
// Set the filter
m_pSet->m_strFilter = "CourseID = " + strCourseID;
// Run the query with the filter in place
if ( m_pSet->Open( CRecordset::snapshot, NULL, CRecordset::readOnly ) )
// Use the recordset
Le recordset contient tous les enregistrements des sections classe de MATH101.
Notez comment la chaîne de filtre a été définie dans l'exemple ci-dessus, à l'aide d'une variable chaîne. Il s'agit là d'une utilisation classique. Mais supposez que vous souhaitiez spécifier la valeur littérale 100 pour l'ID de cours. Le code suivant indique comment définir correctement la chaîne de filtrage avec une valeur littérale :
m_strFilter = "StudentID = '100'"; // correct
Notez l'utilisation des guillemets simples ; si vous définissez directement la chaîne du filtre, celle-ci n'est pas :
m_strFilter = "StudentID = 100"; // incorrect for some drivers
L'utilisation des guillemets ci-dessus est conforme à la spécification ODBC, mais certains SGBD requièrent d'autres types de guillemets. Pour plus d'informations, consultez SQL : personnalisation de l'instruction SQL du recordset (ODBC).
Notes
Si vous choisissez de substituer la chaîne SQL par défaut du recordset en passant votre propre chaîne SQL à la fonction Open, vous ne devez pas définir de filtre lorsque votre chaîne personnalisée contient une clause WHERE.Pour plus d'informations sur la substitution de l'instruction SQL par défaut, consultez SQL : personnalisation de l'instruction SQL du recordset (ODBC).
Voir aussi
Concepts
Recordset : tri d'enregistrements (ODBC)
Recordset : sélection d'enregistrements par les recordsets (ODBC)
Recordset : modification des enregistrements par les recordsets (ODBC)