Méthode DoCmd.SetOrderBy (Access)

Utilisez la méthode SetOrderBy pour appliquer un tri sur la feuille de données, le formulaire, le rapport ou le tableau actif.

Syntaxe

expression. SetOrderBy (OrderBy, ControlName)

expressionune variable représentant un objet DoCmd.

Paramètres

Nom	Requis/Facultatif	Type de données	Description
OrderBy	Obligatoire	Variante	Une expression de chaîne qui inclut le nom du champ ou des champs à partir desquels trier les enregistrements et les mots clés ASC ou DESC facultatifs.
Nom_contrôle	Facultatif	Variante	S'il est fourni et si l'objet actif est un formulaire ou un état, le nom du contrôle qui correspond au sous-formulaire ou au sous-état qui fait l'objet du tri. S’il est vide et si l’objet actif est un formulaire ou un état, le formulaire ou l’état parent est trié.

Remarques

Lorsque vous exécutez cette méthode, le tri est appliqué à la table, au formulaire, à l’état ou à la feuille de données (par exemple, le résultat de la requête) qui est actif et qui a le focus.

L’argument OrderBy est le nom du ou des champs sur lesquels vous souhaitez trier les enregistrements. Lorsque vous utilisez plusieurs noms de champs, séparez-les par une virgule (,). La propriété TriPar de l'objet actif est utilisée pour enregistrer la valeur de tri et l'appliquer ultérieurement. Les valeurs OrderBy sont enregistrées avec les objets dans lequel elles sont créées. Elles sont automatiquement chargées à l'ouverture de l'objet, mais ne sont pas automatiquement appliquées.

Lorsque vous définissez l’argument OrderBy en entrant un ou plusieurs noms de champs, puis que vous exécutez la méthode, les enregistrements sont triés par défaut dans l’ordre croissant.

Pour trier les enregistrements dans l’ordre décroissant, tapez DESC à la fin de l’expression de l’argument OrderBy . Par exemple, pour trier les enregistrements client dans l’ordre décroissant par nom de contact, définissez l’argument OrderBy sur « ContactName DESC ». Pour trier les noms par LastName décroissant et FirstName croissant, définissez l’argument OrderBy sur « LastName DESC, FirstName ASC »

Exemple

L’exemple de code suivant trie la feuille de données active, le formulaire, l’état ou la table par Nom décroissant et FirstName croissant.

DoCmd.SetOrderBy "LastName DESC, FirstName ASC"

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.