Método 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.
Sintaxe
expressão. SetOrderBy (OrderBy, ControlName)
expression Uma variável que representa um objeto DoCmd.
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| OrderBy | Obrigatório | Variant | 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. |
| Controlname | Opcional | Variant | 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. |
Comentários
Quando você executa esse método, a classificação é aplicada à tabela, formulário, relatório ou folha de dados (por exemplo, resultado da consulta) que está ativa e tem o foco.
O argumento OrderBy é o nome do campo ou 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 os registros do cliente em ordem decrescente por nome de contato, defina o argumento OrderBy como "ContactName DESC". Para classificar nomes por LastName decrescente e FirstName crescente, defina o argumento OrderBy como "LastName DESC, FirstName ASC"
Exemplo
O exemplo de código a seguir classifica a planilha de dados ativa, formulário, relatório ou tabela por LastName decrescente e FirstName crescente.
DoCmd.SetOrderBy "LastName DESC, FirstName ASC"
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.