Método NamedRange.Sort

  • Artigo

Classifica os dados em um NamedRange de controle.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
Function Sort ( _
    Key1 As Object, _
    Order1 As XlSortOrder, _
    Key2 As Object, _
    Type As Object, _
    Order2 As XlSortOrder, _
    Key3 As Object, _
    Order3 As XlSortOrder, _
    Header As XlYesNoGuess, _
    OrderCustom As Object, _
    MatchCase As Object, _
    Orientation As XlSortOrientation, _
    SortMethod As XlSortMethod, _
    DataOption1 As XlSortDataOption, _
    DataOption2 As XlSortDataOption, _
    DataOption3 As XlSortDataOption _
) As Object

Object Sort(
    Object Key1,
    XlSortOrder Order1,
    Object Key2,
    Object Type,
    XlSortOrder Order2,
    Object Key3,
    XlSortOrder Order3,
    XlYesNoGuess Header,
    Object OrderCustom,
    Object MatchCase,
    XlSortOrientation Orientation,
    XlSortMethod SortMethod,
    XlSortDataOption DataOption1,
    XlSortDataOption DataOption2,
    XlSortDataOption DataOption3
)

Parâmetros

  • Type
    Tipo: System.Object
    Especifica quais elementos devem ser classificados.Use este argumento somente ao classificar relatórios de tabela dinâmica.
    Pode ser uma das 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.
  • Key3
    Tipo: System.Object
    O terceiro campo de classificação, como texto (um nome de intervalo) ou um Microsoft.Office.Interop.Excel.Range objeto.Se você omitir esse argumento, não há nenhum terceiro campo de classificação.Não pode ser usado ao classificar relatórios de tabela dinâmica.
  • Header
    Tipo: Microsoft.Office.Interop.Excel.XlYesNoGuess
    Especifica se ou não a primeira linha contém cabeçalhos.Não pode ser usado ao classificar relatórios de tabela dinâmica.
    Pode ser uma das seguintes XlYesNoGuess valores:
    xlGuess .Permitir que o Excel de Microsoft Office determinar se há um cabeçalho e para determinar onde ele é, se houver.
    xlNo .(O intervalo inteiro deve ser classificado).
    xlYes .(Todo o intervalo não deve ser classificado).
  • OrderCustom
    Tipo: System.Object
    Esse argumento é um deslocamento inteiro baseado em um à lista de ordens de classificação personalizada.Se você omitir OrderCustom, uma classificação normal é usada.
  • MatchCase
    Tipo: System.Object
    true Para fazer uma classificação diferencia maiúsculas de minúsculas; falsePara 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.
  • SortMethod
    Tipo: Microsoft.Office.Interop.Excel.XlSortMethod
    O tipo de classificação.Algumas dessas constantes podem não estar disponíveis para você, dependendo do suporte a idioma (e.u.a.Inglês, por exemplo) que você selecionou ou instalou.
    Pode ser uma das seguintes XlSortMethod valores:
    xlStroke .Classificação pela quantidade de traços em cada caractere.
    xlPinYin .Ordem de caracteres de classificação fonética chinesa.

Valor de retorno

Tipo: System.Object

Comentários

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

Seqüências de caracteres de texto que não são conversíveis dados numéricos são classificadas normalmente.

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

Optional Parameters

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

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 é para uma personalização em nível de documento.

    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


private void SortNamedRange()
{
    // Set some data in a range of cells.
    this.Range["A1", missing].Value2 = 30;
    this.Range["A2", missing].Value2 = 10;
    this.Range["A3", missing].Value2 = 20;
    this.Range["A4", missing].Value2 = 50;
    this.Range["A5", missing].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);
}

Segurança do .NET Framework

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel