NamedRange.SortSpecial 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.

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

public object SortSpecial (Microsoft.Office.Interop.Excel.XlSortMethod SortMethod = Microsoft.Office.Interop.Excel.XlSortMethod.xlPinYin, object Key1, Microsoft.Office.Interop.Excel.XlSortOrder Order1 = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, object Type, object Key2, 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.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 SortSpecial : Microsoft.Office.Interop.Excel.XlSortMethod * 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.XlSortDataOption * Microsoft.Office.Interop.Excel.XlSortDataOption * Microsoft.Office.Interop.Excel.XlSortDataOption -> obj

Public Function SortSpecial (Optional SortMethod As XlSortMethod = Microsoft.Office.Interop.Excel.XlSortMethod.xlPinYin, Optional Key1 As Object, Optional Order1 As XlSortOrder = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, Optional Type As Object, Optional Key2 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 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

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 (padrão). Ordem de classificação de chinês fonético para caracteres.

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 (padrão). Key1 Classifica em ordem crescente.

Type: Object

Especifica quais elementos devem ser classificados. Use esse argumento somente ao classificar relatórios de Tabela Dinâmica.

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. Não pode ser usado durante a classificação de relatórios de Tabela Dinâmica.

Order2: XlSortOrder

A ordem de classificação para o campo ou intervalo especificado no Key2 argumento . 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 (padrão). 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 no Key3 argumento . 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 (padrão). 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 (padrão). 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, a ordem de 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 (padrão). A classificação é feita por linha. xlSortColumns. A classificação é feita por coluna.

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 (padrão). 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 (padrão). 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 (padrão). Classifica dados numéricos e de texto separadamente.

Retornos

Object

Exemplos

O exemplo de código a seguir usa o SortSpecial método para classificar um NamedRange usando Pin Yin (ordem de classificação chinesa fonética para caracteres). Para classificar caracteres chineses, este exemplo pressupõe que o usuário tenha suporte ao idioma chinês para o Microsoft Office Excel. O Excel usará como padrão classificar o NamedRange por valor se o usuário não tiver suporte para idioma chinês.

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

private void SortSpecialNamedRange()
{
    this.Range["A1"].Value2 = 50;
    this.Range["A2"].Value2 = 10;
    this.Range["A3"].Value2 = 20;
    this.Range["A4"].Value2 = 30;
    this.Range["A5"].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);

}

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

Comentários

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