Sort, propriété
Indique un ou plusieurs noms de champs sur lesquels le jeu d’enregistrements 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 renvoie une valeur String qui indique les noms de champs dans le jeu d’enregistrements sur lequel trier. Chaque nom est séparé par une virgule et est éventuellement suivi d’un mot clé vide 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.
Remarques
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é de tri est prioritaire sur l’ordre spécifié dans une clause ORDER BY incluse dans l’instruction SQL utilisée pour ouvrir le jeu d’enregistrements .
Le recordset de n’a pas besoin d’être ouvert avant d’accéder à la propriété de tri ; 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 jeu d’enregistrements contient trois champs nommés firstName, middleInitialet lastName. Définissez la propriété Sort sur la chaîne «lastName DESC, firstName ASC», qui trie le jeu d’enregistrements par nom dans l’ordre décroissant, puis par prénom dans l’ordre croissant. L’initial du milieu 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 jeu d’enregistrements .
S’applique à
Voir aussi
Sort, propriété - Exemple (VB)
Sort, propriété - Exemple (VC++)
Optimiser Property-Dynamic (ADO)
sortColumn, propriété (RDS)
sortDirection, propriété (RDS)