NamedRange.Sort Método

Referência

Definição

Namespace:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.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 os dados em um controle NamedRange.

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);

abstract member Sort : obj * Microsoft.Office.Interop.Excel.XlSortOrder * obj * obj * Microsoft.Office.Interop.Excel.XlSortOrder * obj * Microsoft.Office.Interop.Excel.XlSortOrder * Microsoft.Office.Interop.Excel.XlYesNoGuess * obj * obj * Microsoft.Office.Interop.Excel.XlSortOrientation * Microsoft.Office.Interop.Excel.XlSortMethod * Microsoft.Office.Interop.Excel.XlSortDataOption * Microsoft.Office.Interop.Excel.XlSortDataOption * Microsoft.Office.Interop.Excel.XlSortDataOption -> obj

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

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

Order1: XlSortOrder

A ordem de classificação para o campo ou intervalo especificado em Key1. Pode ser um dos seguintes XlSortOrder valores: xlDescending. Classifica em ordem decrescente Key1 . xlAscending. Key1 Classifica em ordem crescente.

Key2: Object

O segundo campo de classificação, como texto (um nome de intervalo) ou um objeto Range. Se você omitir esse argumento, não haverá o segundo campo de classificação.

Type: Object

Especifica quais elementos devem ser classificados. Use esse argumento somente ao classificar relatórios de Tabela Dinâmica. Pode ser um dos seguintes XlSortType valores: 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

A ordem de classificação para o intervalo especificado em Key2. Não pode ser usado ao classificar relatórios de tabela dinâmica. Pode ser um dos seguintes XlSortOrder valores: xlDescending. Classifica em ordem decrescente Key2 . xlAscending. Key2 Classifica em ordem crescente.

Key3: Object

O terceiro campo de classificação, como texto (um nome de intervalo) ou um objeto Range. Se você omitir esse argumento, não haverá o terceiro campo de classificação. Não pode ser usado durante a classificação de relatórios de Tabela Dinâmica.

Order3: 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 um dos seguintes XlSortOrder valores: xlDescending. Classifica em ordem decrescente Key3 . xlAscending. Key3 Classifica em ordem crescente.

Header: XlYesNoGuess

Especifica se a primeira linha contém cabeçalhos ou não. Não pode ser usado ao classificar relatórios de tabela dinâmica. Pode ser um dos seguintes XlYesNoGuess valores: xlGuess. Deixe o Microsoft Office Excel determinar se há um cabeçalho e onde ele está, se existir. xlNo. (O intervalo inteiro deve ser classificado.) xlYes. (O intervalo inteiro não deve ser classificado.)

OrderCustom: Object

Esse 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

true para realizar uma classificação que diferencia maiúsculas de minúsculas; false para uma classificação que não diferencia maiúsculas de minúsculas. Não pode ser usado durante a classificação de relatórios de Tabela Dinâmica.

Orientation: XlSortOrientation

A orientação de classificação. Pode ser um dos seguintes XlSortOrientation valores: xlSortRows. Classifica por linha. xlSortColumns. Classifica por coluna.

SortMethod: XlSortMethod

O tipo de classificação. Algumas dessas constantes podem não estar disponíveis para você, dependendo do suporte ao idioma (inglês americano, por exemplo) que você selecionou ou instalou. Pode ser um dos seguintes XlSortMethod valores: xlStroke. Classificação pela quantidade de traços em cada caractere. xlPinYin. Ordem de classificação de chinês fonético para caracteres.

DataOption1: XlSortDataOption

Especifica como classificar o texto em key1. Não pode ser usado ao classificar relatórios de tabela dinâmica. Pode ser um dos seguintes XlSortDataOption valores: xlSortTextAsNumbers. Trata texto como dados numéricos para a classificação. xlSortNormal. Classifica dados numéricos e de texto separadamente.

DataOption2: XlSortDataOption

Especifica como classificar o texto em key2. Não pode ser usado ao classificar relatórios de tabela dinâmica. Pode ser um dos seguintes XlSortDataOption valores: xlSortTextAsNumbers. Trata texto como dados numéricos para a classificação. xlSortNormal. Classifica dados numéricos e de texto separadamente.

DataOption3: XlSortDataOption

Especifica como classificar o texto em key3. Não pode ser usado ao classificar relatórios de tabela dinâmica. Pode ser um dos seguintes XlSortDataOption valores: xlSortTextAsNumbers. Trata texto como dados numéricos para a classificação. xlSortNormal. Classifica dados numéricos e de texto separadamente.

Retornos

Object

Exemplos

O exemplo de código a seguir coloca um conjunto de inteiros nas células A1 a A5 e usa o Sort método para classificar os dados em ordem crescente.

Este exemplo destina-se a uma personalização no nível de documento.

private void SortNamedRange()
{
    // Set some data in a range of cells.
    this.Range["A1"].Value2 = 30;
    this.Range["A2"].Value2 = 10;
    this.Range["A3"].Value2 = 20;
    this.Range["A4"].Value2 = 50;
    this.Range["A5"].Value2 = 40;

    // Create a NamedRange that refers to the range.
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    // Sort the NamedRange.
    namedRange1.Sort(this.Range["A1", "A5"],
        Excel.XlSortOrder.xlAscending,
        missing,
        missing,
        Excel.XlSortOrder.xlAscending,
        missing,
        Excel.XlSortOrder.xlAscending,
        Excel.XlYesNoGuess.xlNo,
        missing,
        missing,
        Excel.XlSortOrientation.xlSortColumns,
        Excel.XlSortMethod.xlStroke,
        Excel.XlSortDataOption.xlSortNormal,
        Excel.XlSortDataOption.xlSortNormal,
        Excel.XlSortDataOption.xlSortNormal);
}

Private Sub SortNamedRange()
    ' Set some data in a range of cells.
    Me.Range("A1").Value2 = 30
    Me.Range("A2").Value2 = 10
    Me.Range("A3").Value2 = 20
    Me.Range("A4").Value2 = 50
    Me.Range("A5").Value2 = 40

    ' Create a NamedRange that refers to the range.
    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
        "namedRange1")

    ' Sort the NamedRange.
    namedRange1.Sort(Me.Range("A1", "A5"), _
        Excel.XlSortOrder.xlAscending, , , _
        Excel.XlSortOrder.xlAscending, , _
        Excel.XlSortOrder.xlAscending, Excel.XlYesNoGuess.xlNo, , , _
        Excel.XlSortOrientation.xlSortColumns, _
        Excel.XlSortMethod.xlStroke, _
        Excel.XlSortDataOption.xlSortNormal, _
        Excel.XlSortDataOption.xlSortNormal, _
        Excel.XlSortDataOption.xlSortNormal)
End Sub

Comentários

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

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

Se nenhum argumento for definido com esse método, o Microsoft Office Excel classificará a seleção em ordem crescente.

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Aplica-se a

Compartilhar via