Table of contents
TOC
Recolher sumário
Expandir sumário

Método DoCmd.SetOrderBy (Access)

office 365 dev account|Última Atualização: 04/10/2017
|
1 Colaborador

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 )

expressão Uma variável que representa um objeto DoCmd.

Parâmetros

NomeObrigatório/opcionalTipo de dadosDescrição
OrderByObrigatórioVariantUma 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.
ControlNameOpcionalVariantSe 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 este método, a classificação é aplicada à tabela, ao formulário, ao relatório ou à folha de dados (por exemplo, o resultado da consulta) que está ativa e tem o foco.

O argumento Classificar por é o nome dos campos cujos registros você deseja classificar. Ao usar mais de um nome de campo, separe-os por vírgula (,). A propriedade OrderBy do objeto ativo é usada para salvar o valor de classificação e aplicá-lo posteriormente. Os valores de OrderBy são salvos com os objetos nos quais são criados. Eles são carregados automaticamente quando o objeto é aberto, mas não são aplicados automaticamente.

Quando você define o argumento Classificar por inserindo um ou mais nomes de campo e executa o método, os registros são classificados por padrão em ordem crescente.

Para classificar os registros em ordem decrescente, digite DECRESC no final da expressão do argumento Order By. Por exemplo, para classificar registros de cliente em ordem decrescente por nome de contato, defina o argumento Order By como "ContactName DESC". Para classificar nomes por LastName em ordem decrescente e FirstName em ordem crescente, defina o argumento Order By como "LastName DESC, FirstName ASC".

Exemplo

O exemplo de código a seguir classifica a folha de dados, o formulário, o relatório ou a tabela ativa por Sobrenome em ordem decrescente e Nome em ordem crescente.

DoCmd.SetOrderBy "LastName DESC, FirstName ASC"

Ver também

Conceitos

Objeto DoCmd

Outros recursos

© 2018 Microsoft