Sort, propriété (ADO)

S’applique à : Access 2013, Office 2013

Indique un ou plusieurs noms de champs selon lesquels le Recordset est trié ; indique en outre si les valeurs des champs sont triés en ordre croissant ou décroissant.

Paramètres et valeurs de retour

Définit ou renvoie une valeur String qui indique les noms des champs du Recorset selon lesquels le tri est réalisé. Les noms sont séparés par des virgules et éventuellement suivis d'un espace puis du mot clé ASC (si les valeurs du champ sont triées en ordre croissant) ou DESC (si les valeurs du champ sont triées en ordre décroissant). Si aucun mot clé n'est spécifié, les valeurs du champ sont par défaut triées en ordre croissant.

Remarques

Cette propriété exige que la propriété CursorLocation ait la valeur adUseClient. Un index temporaire est créé pour chaque champ spécifié dans la propriété Sort si aucun index n'existe déjà.

L'opération de tri est d'une grande efficacité parce que les données ne sont pas réorganisées physiquement mais sont simplement lues dans l'ordre spécifié par l'index.

Le fait de donner une chaîne vide comme valeur à la propriété Sort réinitialise les lignes dans leur ordre d'origine et supprime les index temporaires. En revanche, les index existants seront conservés.

Supposons qu’un objet Recordset contienne trois champs nommés firstName, middleInitial et lastName. Définissez la propriété Sort sur la chaîne « lastName DESC, firstName ASC », qui trie l’objet Recordset par nom dans l’ordre décroissant, puis par prénom dans l’ordre croissant. Le deuxième prénom (middle initial) est ignoré.

Les champs ne peuvent pas être nommés « ASC » ou « DESC » car ces noms génèrent des conflits avec les mots-clés ASC et DESC. Si le nom d'un champ génère un conflit, donnez-lui un alias en utilisant le mot-clé AS dans la requête qui renvoie le Recordset.