Range.Sort Método

Referência

Definição

Namespace:: Microsoft.Office.Interop.Excel

Assembly:: Microsoft.Office.Interop.Excel.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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 um 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 Key1 em ordem decrescente. xlAscending default . Classifica Key1 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 de 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 de 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 Key2 em ordem decrescente. xlAscending default . Classifica Key2 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 Key3 em ordem decrescente. xlAscending default . Classifica Key3 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. Vamos Microsoft Excel determinar se há um header e determinar onde ele está se houver um. xlNo default . (Todo o intervalo deve ser organizado). xlYes. (O intervalo inteiro não deve ser classificação).

OrderCustom: Object

Objeto Opcional. Este argumento é um deslocamento de inteiro baseado em um para a lista de ordens de classificação personalizadas. Se você OrderCustom omitir , 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: xlSortRows default . 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: classificação xlStroke pela quantidade de traços em cada caractere. xlPinYin default . Ordem de classificação do chinês fonético para caracteres.

DataOption1: XlSortDataOption

Opcional XlSortDataOption . Especifica como classificar 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 a classificação. xlSortNormal default . Classifica dados numéricos e de texto separadamente.

DataOption2: XlSortDataOption

Opcional XlSortDataOption . Especifica como classificar 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 a classificação. xlSortNormal default . Classifica dados numéricos e de texto separadamente.

DataOption3: XlSortDataOption

Opcional XlSortDataOption . Especifica como classificar texto na tecla 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 a classificação. xlSortNormal default . Classifica dados numéricos e de texto separadamente.

Retornos

Object

Comentários

As configurações para , , , , , e são salvas, para Header Order1 a planilha Order2 Order3 OrderCustom Orientation específica, sempre 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. De definir esses argumentos explicitamente cada vez que você usar o método Sort se optar por não usar os valores salvos.

Cadeias de caracteres de texto que não são conversíveis para dados numéricos são classificação 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.

Aplica-se a