CRecordset::m_strSort

Après avoir construit l'objet recordset, mais avant d'appeler sa fonction membre de Ouvrir , utilisez ce membre pour stocker CString contenant une clause SQL ORDER BY .

Notes

Le recordset utilise la chaîne pour trier les enregistrements qu'il sélectionne pendant Ouvrir ou l'appel de Requery .  Vous pouvez utiliser cette fonctionnalité pour trier un recordset sur une ou plusieurs colonnes.  La syntaxe ODBC SQL pour une clause de ORDER BY est  

ORDER BY sort-specification [, sort-specification]...

où un tri- spécification est un entier ou un nom de colonne.  Vous pouvez également spécifier l'ordre croissant ou décroissant (la commande est croissante par défaut) en ajoutant le « ASC » ou « DESC » à la liste des colonnes dans la chaîne de tri.  Les enregistrements sélectionnés sont triés d'abord par la première colonne répertoriée, puis par la deuxième, et ainsi de suite.  Par exemple, vous pouvez classer un recordset « customers » par le nom, le prénom.  Le nombre de colonnes que vous pouvez répertorier dépend de la source de données.  Pour plus d'informations, consultez SDK Windows*.*  

Notez que vous n'incluez pas le mot clé de ORDER BY dans votre chaîne.  La fournit l'infrastructure.  

Pour plus d'informations sur les clauses SQL, consultez l'article SQL.  Pour plus d'informations sur les enregistrements de tri, consultez l'article recordset : Tri d'enregistrements (ODBC).  

Exemple

CCustomer rsCustSet(&m_dbCust);

// Set the sort string
rsCustSet.m_strSort = _T("L_Name, ContactFirstName");

// Run the sorted query
rsCustSet.Open(CRecordset::snapshot, _T("Customer"));

Configuration requise

Header: afxdb.h

Voir aussi

CRecordset Class
Graphique hiérarchique
CRecordset::m_strFilter
CRecordset::Requery