NamedRange.SortSpecial Método

Referencia

Definición

Espacio de nombres:: Microsoft.Office.Tools.Excel

Ensamblado:: Microsoft.Office.Tools.Excel.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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.

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

Tipo de ordenación. Es posible que algunas de estas constantes no estén disponibles, dependiendo de la compatibilidad con idiomas (por ejemplo, inglés de EE. UU.) que haya seleccionado o instalado. Puede ser uno de los valores siguientes 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.

Key1: Object

El primer campo de ordenación, como texto (un nombre de rango) o un Range objeto ("Dept" o Cells(1, 1), por ejemplo).

Order1: XlSortOrder

Criterio de ordenación del campo o intervalo especificado en Key1. Puede ser uno de los valores siguientes XlSortOrder : xlDescending. Ordena Key1 en orden descendente. xlAscending (valor predeterminado). Ordena Key1 en orden ascendente.

Type: Object

Especifica qué elementos se van a ordenar. Este argumento sólo se utiliza cuando se ordenan informes de tabla dinámica.

Key2: Object

Segundo campo de ordenación, ya sea texto (nombre de rango) o un objeto Range. Si omite este argumento, no hay segundo campo de ordenación. No se puede utilizar cuando se ordenan informes de tabla dinámica.

Order2: XlSortOrder

Criterio de ordenación del campo o intervalo especificado en el Key2 argumento . No se puede usar al ordenar informes de tabla dinámica. Puede ser uno de los valores siguientes XlSortOrder : xlDescending. Ordena Key2 en orden descendente. xlAscending (valor predeterminado). Ordena Key2 en orden ascendente.

Key3: Object

Tercer campo de ordenación, ya sea texto (nombre de rango) o un objeto Range. Si omite este argumento, no hay tercer campo de ordenación. No se puede utilizar cuando se ordenan informes de tabla dinámica.

Order3: XlSortOrder

Criterio de ordenación del campo o intervalo especificado en el Key3 argumento . No se puede usar al ordenar informes de tabla dinámica. Puede ser uno de los valores siguientes XlSortOrder : xlDescending. Ordena Key3 en orden descendente. xlAscending (valor predeterminado). Ordena Key3 en orden ascendente.

Header: XlYesNoGuess

Indica si la primera fila contiene encabezados o no. No se puede usar al ordenar informes de tabla dinámica. Puede ser uno de los valores siguientes 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: Object

Este argumento indica el desplazamiento de enteros de base uno en la lista de criterios de ordenación personalizados. Si omite OrderCustom, se usa el criterio de ordenación normal.

MatchCase: 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.

Orientation: XlSortOrientation

Orientación de ordenación. Puede ser uno de los valores siguientes XlSortOrientation : xlSortRows (valor predeterminado). La ordenación se lleva a cabo por fila. xlSortColumns. La ordenación se lleva a cabo por columna.

DataOption1: XlSortDataOption

Especifica cómo ordenar texto en key1. No se puede usar al ordenar informes de tabla dinámica. Puede ser uno de los valores siguientes XlSortDataOption : xlSortTextAsNumbers. Trata el texto como datos numéricos en la ordenación. xlSortNormal (predeterminado). Ordena datos numéricos y de texto por separado.

DataOption2: XlSortDataOption

Especifica cómo ordenar texto en key2. No se puede usar al ordenar informes de tabla dinámica. Puede ser uno de los valores siguientes XlSortDataOption : xlSortTextAsNumbers. Trata el texto como datos numéricos en la ordenación. xlSortNormal (predeterminado). Ordena datos numéricos y de texto por separado.

DataOption3: XlSortDataOption

Especifica cómo ordenar texto en key3. No se puede usar al ordenar informes de tabla dinámica. Puede ser uno de los valores siguientes XlSortDataOption : xlSortTextAsNumbers. Trata el texto como datos numéricos en la ordenación. xlSortNormal (predeterminado). Ordena datos numéricos y de texto por separado.

Devoluciones

Object

Ejemplos

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

Este ejemplo es para una personalización de nivel 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

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 los parámetros opcionales, vea Parámetros opcionales en soluciones de Office.

Se aplica a

Compartir a través de