Compartilhar via

Método NamedRange.Sort

  • Artigo

Classifica os dados em um controle de NamedRange .

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 que elementos devem ser classificados.Use esse argumento somente classificação relatórios de tabela dinâmica.
    Pode ser um dos seguintes valores de XlSortType :
    xlSortLabels.Classes do relatório de tabela por dinâmica rótulos.
    xlSortValues.Classes do relatório de tabela dinâmica por valores.
  • Key3
    Tipo: System.Object
    O terceiro campo de tipo, como texto (um nome de intervalo) ou um objeto de Microsoft.Office.Interop.Excel.Range .Se você omitir este argumento, não há terceiro campo de tipo.Não pode ser usado para classificar relatórios de tabela dinâmica.
  • Header
    Tipo: Microsoft.Office.Interop.Excel.XlYesNoGuess
    Especifica se a primeira linha contém cabeçalhos.Não pode ser usado para classificar relatórios de tabela dinâmica.
    Pode ser um dos seguintes valores de XlYesNoGuess :
    xlGuess.Deixe o Microsoft Office Excel determinar se houver um cabeçalho, e determinar onde está, se houver.
    xlNo. (O intervalo inteiro deve ser classificado).
    xlYes. (O intervalo inteiro não deve ser classificado).
  • OrderCustom
    Tipo: System.Object
    Esse argumento é um deslocamento baseado em um inteiro à lista de pedidos de classificação personalizados.Se você omitir OrderCustom, um tipo comum é usado.
  • MatchCase
    Tipo: System.Object
    true para fazer um tipo com diferenciação de maiúsculas e minúsculas; false para fazer um tipo que não é maiúsculas de minúsculas.Não pode ser usado para classificar relatórios de tabela dinâmica.
  • SortMethod
    Tipo: Microsoft.Office.Interop.Excel.XlSortMethod
    O tipo de tipo.Algumas dessas constantes podem não estar disponíveis para você, como o suporte a linguagem (EUA]).Inglês, por exemplo) que você selecionou ou instalado.
    Pode ser um dos seguintes valores de XlSortMethod :
    xlStroke.Classificação pela quantidade de traços em cada caractere.
    xlPinYin.Ordem de classificação chinês fonético para caracteres.

Valor de retorno

Tipo: System.Object

Comentários

As configurações para Header, Order1, Order2, Order3, OrderCustom, e Orientation são salvas, para a planilha específico, cada vez que você usa esse método. Se você não especificar valores para esses argumentos na próxima vez que você chama o método, os valores salvos é usado. Definir esses argumentos explicitamente cada vez que você usa 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 a dados numéricos são classificadas normalmente.

Se nenhum argumento é definido com esse método, Microsoft Office Excel classificação a seleção na ordem crescente.

Parâmetros Opcionais

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

Exemplos

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

Este exemplo é para uma personalização de um documento nível.

    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"].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);
}

Segurança do .NET Framework

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel