Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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. |
| NomeDoControlo | 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 executa este método, a ordenaçã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 pretende ordenar registos. 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 define o argumento OrderBy ao introduzir um ou mais nomes de campo e, em seguida, executar o método, os registos são ordenados por predefinição por ordem ascendente.
Para ordenar registos por ordem descendente, escreva DESC no final da expressão de argumento OrderBy . Por exemplo, para ordenar registos de clientes por ordem descendente por nome de contacto, defina o argumento OrderBy como "ContactName DESC". Para ordenar nomes por Apelido descendente e NomePróprio ascendente, defina o argumento OrderBy como "LastName DESC, FirstName ASC"
Exemplo
O seguinte exemplo de código ordena a folha de dados ativa, formulário, relatório ou tabela por Apelido descendente e NomePróprio ascendente.
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.