CRecordset::m_strSort

Remarques

Après que vous construisez l'objet recordset, mais avant que vous appelez sa fonction membre Open , utilisez ce membre de données pour stocker un CString contenant une clause SQL ORDER BY . Le jeu d'enregistrements utilise cette chaîne pour trier les enregistrements qu'il sélectionne lors de l'appel ouvert ou actualiser . Vous pouvez utiliser cette fonctionnalité pour trier un jeu d'enregistrements sur une ou plusieurs colonnes. La syntaxe SQL ODBC pour une clause ORDER BY est

ORDRE de tri-spécification [, spécification de tri]...

lorsqu'une spécification de tri est un entier ou un nom de colonne. Vous pouvez également spécifier ordre ascendant ou descendant (l'ordre est ascendant par défaut) par l'ajout de « 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 de liste, puis par le deuxième et ainsi de suite. Par exemple, vous pouvez commander un jeu d'enregistrements de « Clients » par le nom, puis par prénom. Le nombre de colonnes de que la liste dépend de la source de données. Pour plus d'informations, consultez la référence du programmeur ODBC SDK.

Notez que vous n'incluez pas le mot-clé ORDER BY dans votre chaîne. Le cadre fournit elle.

Pour plus d'informations sur les clauses SQL, consultez l'article SQL. Pour plus d'informations sur le tri des dossiers, consultez l'article jeu d'enregistrements : tri enregistrements (ODBC). Les deux articles sont dans le Guide du programmeur Visual C++.

Exemple

/ / Exemple de CRecordset::m_strSort

CCustSet rsCustSet (NULL) ;

/ / Définir la chaîne de tri
rsCustSet.m_strSort = « District, Last_Name » ;

/ / Exécute la requête triée
rsCustSet.Open (CRecordset::snapshot, « Customers »)

Aperçu de CRecordset |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CRecordset::m_strFilter, CRecordset::Requery

Index