Sort, propriété

Indique un ou plusieurs noms de champs sur lesquels l’objet Recordset est trié, et indique si chaque champ est trié dans l’ordre croissant ou décroissant.

Paramètres et valeurs de retour

Définit ou retourne une valeur String qui indique les noms de champs dans le Recordset sur lequel trier. Chaque nom est séparé par une virgule, et est éventuellement suivi d’un mot clé et du mot clé, ASC, qui trie le champ dans l’ordre croissant ou DESC, qui trie le champ dans l’ordre décroissant. Par défaut, si aucun mot clé n’est spécifié, le champ est trié dans l’ordre croissant.

Notes

Cette propriété nécessite que la propriété CursorLocation soit définie sur adUseClient. Un index temporaire est créé pour chaque champ spécifié dans la propriété Sort si un index n’existe pas déjà.

L’opération de tri est efficace, car les données ne sont pas réorganisés physiquement, mais sont simplement accessibles dans l’ordre spécifié par l’index.

Lorsque la valeur de la propriété Sort n’est autre qu’une chaîne vide, l’ordre de propriété Sort est prioritaire sur l’ordre spécifié dans une clause ORDER BY incluse dans l’instruction SQL utilisée pour ouvrir l’objet Recordset.

Le Recordset ne doit pas être ouvert avant d’accéder à la propriété Sort; il peut être défini à tout moment après l’instanciation de l’objet Recordset.

La définition de la propriété Sort sur une chaîne vide réinitialise les lignes à leur ordre d’origine et supprime les index temporaires. Les index existants ne seront pas supprimés.

Supposons qu’un Recordset contient trois champs nommés firstName, middleInitial et lastName. Définissez la propriété Sort sur la chaîne « lastName DESC, firstName ASC », qui commande le Recordset par nom dans l’ordre décroissant, puis par prénom dans l’ordre croissant. L’initial intermédiaire est ignoré.

Aucun champ ne peut être nommé « ASC » ou « DESC », car ces noms sont en conflit avec les mots clés ASC et DESC. Vous pouvez créer un alias pour un champ avec un nom en conflit à l’aide du mot clé AS dans la requête qui retourne le Recordset.

S'applique à

Recordset, objet (ADO)

Voir aussi

Sort, exemple de propriétés (VB)
Sort, exemple de propriétés (VC++)
Optimize, propriété dynamique (ADO)
SortColumn, propriété (RDS)
SortDirection, propriété (RDS)