DoCmd.SetOrderBy (Access)

Use o método SetOrderBy para aplicar uma classificação à folha de dados, ao formulário, ao relatório ou à tabela ativa.

Quando você executa esse método, a classificação é aplicada à tabela, ao formulário, ao relatório ou à folha de (por exemplo, o resultado da consulta) que está ativa e tem o foco. O argumento OrderBy é o nome do campo ou dos campos nos quais você deseja classificar registros. Quando você usa mais de um nome de campo, separe-os com vírgula (,). A propriedade OrderBy do objeto ativo é usada para salvar um valor de classificação e aplicá-lo posteriormente. Valores de OrderBy são salvos com os objetos nos quais eles são criados. Eles são carregados automaticamente quando o objeto é aberto, mas não são aplicadas automaticamente. Quando você define o argumento OrderBy inserindo um ou mais nomes de campo e, em seguida, executa o método, os registros são classificados por padrão em ordem crescente. Para classificar registros em ordem decrescente, digite DESC no final da expressão de argumento OrderBy . Por exemplo, para classificar registros de cliente em ordem decrescente por nome de contato, defina o argumento OrderBy como "ContactName desc". Para classificar nomes por LastName Descending e FirstName Ascending, defina o argumento OrderBy como "LastName DESC, FirstName ASC"

SetOrderBy (OrderBy, ControlName)

DoCmd.SetOrderBy "LastName DESC, FirstName ASC"

Arguments

O seguinte argumento é necessário

OrderBy (String) - Uma expressão de cadeia de caracteres que inclui o nome do(s) campo(s) no(s) qual(is) serão classificados os registros e as palavras-chave CRESC ou DECRESC opcionais.

Optional arguments

The following argument is optional

ControlName (String) - Se for fornecido e o objeto ativo for um formulário ou relatório, o nome do controle que corresponde ao subformulário ou sub-relatório que será classificado. Se estiver vazio e o objeto ativo for um formulário ou relatório, o formulário ou relatório pai será classificado.