Range.Sort Método

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Classifica um relatório de Tabela Dinâmica, um intervalo ou a região ativa se o intervalo especificado contiver apenas uma célula.

public object Sort (object Key1, Microsoft.Office.Interop.Excel.XlSortOrder Order1 = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, object Key2, object Type, Microsoft.Office.Interop.Excel.XlSortOrder Order2 = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, object Key3, Microsoft.Office.Interop.Excel.XlSortOrder Order3 = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, Microsoft.Office.Interop.Excel.XlYesNoGuess Header = Microsoft.Office.Interop.Excel.XlYesNoGuess.xlNo, object OrderCustom, object MatchCase, Microsoft.Office.Interop.Excel.XlSortOrientation Orientation = Microsoft.Office.Interop.Excel.XlSortOrientation.xlSortRows, Microsoft.Office.Interop.Excel.XlSortMethod SortMethod = Microsoft.Office.Interop.Excel.XlSortMethod.xlPinYin, Microsoft.Office.Interop.Excel.XlSortDataOption DataOption1 = Microsoft.Office.Interop.Excel.XlSortDataOption.xlSortNormal, Microsoft.Office.Interop.Excel.XlSortDataOption DataOption2 = Microsoft.Office.Interop.Excel.XlSortDataOption.xlSortNormal, Microsoft.Office.Interop.Excel.XlSortDataOption DataOption3 = Microsoft.Office.Interop.Excel.XlSortDataOption.xlSortNormal);

Public Function Sort (Optional Key1 As Object, Optional Order1 As XlSortOrder = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, Optional Key2 As Object, Optional Type As Object, Optional Order2 As XlSortOrder = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, Optional Key3 As Object, Optional Order3 As XlSortOrder = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, Optional Header As XlYesNoGuess = Microsoft.Office.Interop.Excel.XlYesNoGuess.xlNo, Optional OrderCustom As Object, Optional MatchCase As Object, Optional Orientation As XlSortOrientation = Microsoft.Office.Interop.Excel.XlSortOrientation.xlSortRows, Optional SortMethod As XlSortMethod = Microsoft.Office.Interop.Excel.XlSortMethod.xlPinYin, Optional DataOption1 As XlSortDataOption = Microsoft.Office.Interop.Excel.XlSortDataOption.xlSortNormal, Optional DataOption2 As XlSortDataOption = Microsoft.Office.Interop.Excel.XlSortDataOption.xlSortNormal, Optional DataOption3 As XlSortDataOption = Microsoft.Office.Interop.Excel.XlSortDataOption.xlSortNormal) As Object

Parâmetros

Key1

Object

Objeto opcional. O primeiro campo de classificação, como texto (um campo de Tabela Dinâmica ou nome de intervalo) ou um Range objeto ("Dept" ou Cells(1, 1), por exemplo).

Order1

XlSortOrder

Opcional XlSortOrder. A ordem de classificação para o campo ou intervalo especificado em Key1. Pode ser uma das seguintes constantes XlSortOrder :xlDescending. Classifica em ordem decrescente Key1 .xlAscendingdefault. Key1 Classifica em ordem crescente.

Key2

Object

Objeto opcional. O segundo campo de classificação, como texto (um campo de tabela dinâmica ou nome de intervalo) ou um objeto Range. Se você omitir este argumento, não haverá um segundo campo de classificação. Não é possível usar ao classificar relatórios da Tabela Dinâmica.

Type

Object

Objeto opcional. Especifica os elementos que devem ser classificados. Use este argumento somente ao classificar relatórios de tabela dinâmica. Pode ser uma das seguintes constantes XlSortType :xlSortLabels. Classifica o relatório tabela dinâmica por rótulos. xlSortValues. Classifica o relatório de tabela dinâmica por valores.

Order2

XlSortOrder

Opcional XlSortOrder. A ordem de classificação para o campo ou intervalo especificado em Key2. Não pode ser usado ao classificar relatórios de tabela dinâmica. Pode ser uma das seguintes constantes XlSortOrder :xlDescending. Classifica em ordem decrescente Key2 .xlAscendingdefault. Key2 Classifica em ordem crescente.

Key3

Object

Objeto opcional. O terceiro campo de classificação, como texto (um nome de intervalo) ou um objeto Range. Se você omitir este argumento, não haverá um terceiro campo de classificação. Não pode ser usado ao classificar relatórios de tabela dinâmica.

Order3

XlSortOrder

Opcional XlSortOrder. A ordem de classificação para o campo ou intervalo especificado em Key3. Não pode ser usado ao classificar relatórios de tabela dinâmica. Pode ser uma das seguintes constantes XlSortOrder :xlDescending. Classifica em ordem decrescente Key3 .xlAscendingdefault. Key3 Classifica em ordem crescente.

Header

XlYesNoGuess

Opcional XlYesNoGuess. Especifica se a primeira linha contém ou não cabeçalhos. Não pode ser usado ao classificar relatórios de tabela dinâmica. Pode ser uma das seguintes constantes XlYesNoGuess :xlGuess. Deixe o Microsoft Excel determinar se há um cabeçalho e determine onde ele está se houver um. xlNodefault. (Todo o intervalo deve ser classificado). xlYes. (Todo o intervalo não deve ser classificado).

OrderCustom

Object

Objeto opcional. Este argumento é um deslocamento de inteiro baseado em um para a lista de ordens de classificação personalizadas. Se você omitir OrderCustom, uma classificação normal será usada.

MatchCase

Object

Objeto opcional. True para fazer uma classificação que diferencia maiúsculas de minúsculas; False para fazer uma classificação que não diferencia maiúsculas de minúsculas. Não pode ser usado ao classificar relatórios de tabela dinâmica.

Orientation

XlSortOrientation

Opcional XlSortOrientation. A orientação da classificação. Pode ser uma das seguintes constantes xlSortOrientation :xlSortRowsdefault. Classifica por linha. xlSortColumns. Classifica por coluna.

SortMethod

XlSortMethod

Opcional XlSortMethod. O tipo de classificação. Algumas dessas constantes podem não estar disponíveis, dependendo do suporte a idioma (português do Brasil, por exemplo) que você selecionou ou instalou. Pode ser uma das seguintes constantes XlSortMethod :xlStroke Classificação pela quantidade de traços em cada caractere. xlPinYindefault. Ordem de classificação do chinês fonético para caracteres.

DataOption1

XlSortDataOption

Opcional XlSortDataOption. Especifica como classificar o texto em Key 1. Não pode ser usado ao classificar relatórios de tabela dinâmica. Pode ser uma das seguintes constantes XlSortDataOption :xlSortTextAsNumbers. Trate o texto como dados numéricos para o tipo. xlSortNormaldefault. Classifica dados numéricos e de texto separadamente.

DataOption2

XlSortDataOption

Opcional XlSortDataOption. Especifica como classificar o texto em Key 2. Não pode ser usado ao classificar relatórios de tabela dinâmica. Pode ser uma das seguintes constantes XlSortDataOption :xlSortTextAsNumbers. Trata o texto como dados numéricos para o tipo. xlSortNormaldefault. Classifica dados numéricos e de texto separadamente.

DataOption3

XlSortDataOption

Opcional XlSortDataOption. Especifica como classificar o texto na chave 3. Não pode ser usado ao classificar relatórios de tabela dinâmica. Pode ser uma das seguintes constantes XlSortDataOption :xlSortTextAsNumbers. Trata o texto como dados numéricos para o tipo. xlSortNormaldefault. Classifica dados numéricos e de texto separadamente.

Retornos

Object

Comentários

As configurações para Header, Order1, Order2, Order3, OrderCustome Orientation são salvas, para a planilha específica, cada vez que você usa esse método. Se você não especificar valores para esses argumentos na próxima vez que chamar o método, os valores salvos serão usados. Defina esses argumentos explicitamente cada vez que você usar o método Sort se optar por não usar os valores salvos.

As cadeias de caracteres de texto que não são conversíveis para dados numéricos são classificadas normalmente.

Se não houver argumentos definidos com o método Sort, o Microsoft Excel classificará a seleção, escolhida para classificação, na ordem crescente.