Compartir a través de

NamedRange.SortSpecial (Método)

  • Artículo

Utiliza los métodos de ordenación asiáticos orientales para ordenar el control NamedRange. Por ejemplo, el japonés ordena en el orden de syllabary de Kana. Para obtener más información, vea la lista de parámetros.

Espacio de nombres:  Microsoft.Office.Tools.Excel
Ensamblado:  Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)

Sintaxis

'Declaración
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
    Tipo de ordenación.Algunas de estas constantes puede que no estén disponibles para usted, dependiendo de la compatibilidad con idiomas (por ejemplo, español, alfabetización internacional) que se haya seleccionado o instalado.
    Puede ser uno de los siguientes valores de XlSortMethod:
    xlStroke.Ordenación por la cantidad de trazos de cada carácter.
    xlPinYin (predeterminado).Criterio de ordenación fonética de los caracteres en chino.
  • Type
    Tipo: System.Object
    Especifica qué elementos se van a ordenar.Este argumento sólo se utiliza cuando se ordenan informes de tabla dinámica.
  • Key2
    Tipo: System.Object
    Segundo campo de ordenación, ya sea texto (nombre de rango) o un objeto Microsoft.Office.Interop.Excel.Range.Si omite este argumento, no hay segundo campo de ordenación.No se puede utilizar cuando se ordenan informes de tabla dinámica.
  • Key3
    Tipo: System.Object
    Tercer campo de ordenación, ya sea texto (nombre de rango) o un objeto Microsoft.Office.Interop.Excel.Range.Si omite este argumento, no hay tercer campo de ordenación.No se puede utilizar cuando se ordenan informes de tabla dinámica.
  • Header
    Tipo: Microsoft.Office.Interop.Excel.XlYesNoGuess
    Indica si la primera fila contiene encabezados o no.No se puede utilizar cuando se ordenan informes de tabla dinámica.
    Puede ser uno de los siguientes valores de XlYesNoGuess:
    xlGuess.Permite que Microsoft Office Excel determine si hay un encabezado y, si lo hay, dónde está.
    xlNo (predeterminado).Se debe ordenar el rango completo.
    xlYes.No se debe ordenar el rango completo.
  • OrderCustom
    Tipo: System.Object
    Este argumento indica el desplazamiento de enteros de base uno en la lista de criterios de ordenación personalizados.Si omite OrderCustom, se utiliza el criterio de ordenación normal.
  • MatchCase
    Tipo: System.Object
    Es true para realizar una ordenación con distinción de mayúsculas y minúsculas, y es false para realizar una ordenación sin esta distinción.No se puede utilizar cuando se ordenan informes de tabla dinámica.

Valor devuelto

Tipo: System.Object

Comentarios

Si no se define ningún argumento con este método, Microsoft Office Excel ordena la selección en orden ascendente.

Parámetros opcionales

Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.

Ejemplos

En el ejemplo de código siguiente se utiliza el método SortSpecial para ordenar NamedRange mediante Pin Yin (criterio de ordenación fonético chino para los caracteres). Para ordenar los caracteres chinos, este ejemplo supone que el usuario tiene compatibilidad con el idioma chino para Microsoft Office Excel. Excel tendrá como valor predeterminado la ordenación de NamedRange por valor si el usuario no tiene compatibilidad con el idioma chino.

Se trata de un ejemplo para una personalización en el nivel del 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);
}

Seguridad de .NET Framework

Vea también

Referencia

NamedRange Interfaz

Microsoft.Office.Tools.Excel (Espacio de nombres)