Método NamedRange.SortSpecial

  • Artigo

Usa métodos de classificação do Leste Asiático para classificar o NamedRange de controle. Por exemplo, japonês classifica na ordem de classificação silábica Kana. Para obter mais informações, consulte a lista de parâmetros.

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

Sintaxe

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

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

Parâmetros

  • 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 (padrão).Ordem de caracteres de classificação fonética chinesa.
  • Type
    Tipo: System.Object
    Especifica quais elementos devem ser classificados.Use este argumento somente ao classificar relatórios de tabela dinâmica.
  • Key2
    Tipo: System.Object
    O segundo campo de classificação, como texto (um nome de intervalo) ou um Microsoft.Office.Interop.Excel.Range objeto.Se você omitir esse argumento, há um segundo campo de classificação.Não pode ser usado ao classificar relatórios de tabela dinâmica.
  • 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 .Permite que o Excel de Microsoft Office determinar se há um cabeçalho e para determinar onde ele é, se houver.
    xlNo (padrão).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, a ordem de classificação normal é usado.
  • 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.

Valor de retorno

Tipo: System.Object

Comentários

Se nenhum argumento é definido com esse método, o Excel de Microsoft Office classifica 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 seguinte exemplo de código usa a SortSpecial método para classificar um NamedRange usando Pin Yin (ordem de caracteres de classificação fonética chinesa). Para classificar caracteres chineses, este exemplo pressupõe que o usuário tem o idioma chinês de suporte para o Excel de Microsoft Office. O padrão do Excel será a classificação de NamedRange por valor se o usuário não tem suporte de idioma chinês.

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

    Private Sub SortSpecialNamedRange()
        Me.Range("A1").Value2 = 50
        Me.Range("A2").Value2 = 10
        Me.Range("A3").Value2 = 20
        Me.Range("A4").Value2 = 30
        Me.Range("A5").Value2 = 40

        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
            "namedRange1")

        namedRange1.SortSpecial(Excel.XlSortMethod.xlPinYin, _
            Me.Range("A1", "A5"), Excel.XlSortOrder.xlAscending, , , _
            Excel.XlSortOrder.xlAscending, , _
            Excel.XlSortOrder.xlAscending, _
            Excel.XlYesNoGuess.xlNo, , , _
            Excel.XlSortOrientation.xlSortColumns, _
            Excel.XlSortDataOption.xlSortNormal, _
            Excel.XlSortDataOption.xlSortNormal, _
            Excel.XlSortDataOption.xlSortNormal)
    End Sub


private void SortSpecialNamedRange()
{
    this.Range["A1", missing].Value2 = 50;
    this.Range["A2", missing].Value2 = 10;
    this.Range["A3", missing].Value2 = 20;
    this.Range["A4", missing].Value2 = 30;
    this.Range["A5", missing].Value2 = 40;

    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    namedRange1.SortSpecial(Excel.XlSortMethod.xlPinYin,
        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.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