Método SortFields.Add (Excel)

Cria um novo campo de classificação e retorna um objeto SortFields.

Sintaxe

expressão. Adicionar (Key, SortOn, Order, CustomOrder, DataOption)

Expressão Uma variável que representa um objeto SortFields .

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Tecla	Obrigatório	Range	Especifica um valor de tecla para a classificação.
SortOn	Opcional	Variantes	O campo a ser classificado.
Order	Opcional	Variantes	Especifica a ordem de classificação.
CustomOrder	Opcional	Variantes	Especifica se uma ordem de classificação personalizada deve ser usada.
DataOption	Opcional	Variantes	Especifica a opção de dados.

Valor de retorno

SortField

Comentários

Essa API não inclui suporte para tipos de dados, como Geografia ou Estoques. Para definir uma ordem de classificação com base em um SubField de um desses tipos, consulte o método Add2 .

Exemplo

Este exemplo classifica uma tabela, Table1 na Planilha1, por Coluna1 em ordem crescente.

O método Clear é chamado antes para garantir que o tipo anterior seja limpo para que um novo possa ser aplicado.

O objeto Sort é chamado para aplicar a classificação adicionada à Table1.

ActiveWorkbook.Worksheets("Sheet1").ListObjects("Table1").Sort.SortFields.Clear
ActiveWorkbook.Worksheets("Sheet1").ListObjects("Table1").Sort.SortFields.Add _
 Key:=Range("Table1[[#All],[Column1]]"), _
 SortOn:=xlSortOnValues, _
 Order:=xlAscending, _
 DataOption:=xlSortNormal
With ActiveWorkbook.Worksheets("Sheet1").ListObjects("Table1").Sort
 .Header = xlYes
 .MatchCase = False
 .Orientation = xlTopToBottom
 .SortMethod = xlPinYin
 .Apply
End With

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.