Range.Sort Método

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 nome de intervalo) ou um Range objeto ("Departamento" ou Células(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 constantes XlSortOrder a seguir:xlDescending. Classifica Key1 em ordem decrescente.xlCrescentedefault. 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 pode ser usado durante a classificação de 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 constantes XlSortType a seguir: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 constantes XlSortOrder a seguir:xlDescending. Classifica Key2 em ordem decrescente.xlCrescentedefault. 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 constantes XlSortOrder a seguir:xlDescending. Classifica Key3 em ordem decrescente.xlCrescentedefault. 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. Deixe o Microsoft Excel determinar se há um cabeçalho e determine onde ele está, se houver um. xlNãodefault. (Todo o intervalo deve ser classificado). xlSim. (O intervalo inteiro 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 constantes XlSortOrientation a seguir:xlSortRowsdefault. Classifica por linhas. 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 constantes XlSortDataOption a seguir:xlSortTextAsNumbers. Tratar texto como dados numéricos para a classificação. 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 constantes XlSortDataOption a seguir:xlSortTextAsNumbers. Trata texto como dados numéricos para a classificação. 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 constantes XlSortDataOption a seguir:xlSortTextAsNumbers. Trata texto como dados numéricos para a classificação. xlSortNormaldefault. Classifica dados numéricos e de texto separadamente.

Retornos

Object

Comentários

As configurações de Header, Order1, Order2Order3OrderCustome Orientation são salvas para uma 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 sempre que usar o método Sort , caso opte por não usar os valores salvos.

As cadeias de texto que não são conversíveis em 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.

Aplica-se a

Comentários

Esta página foi útil?