NamedRange.Sort (Método)

  • Artículo

Ordena los datos en un control NamedRange.

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

Sintaxis

'Declaración
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 qué elementos se van a ordenar.Este argumento sólo se utiliza cuando se ordenan informes de tabla dinámica.
    Puede ser uno de los siguientes valores de XlSortType:
    xlSortLabels.Ordena el informe de tabla dinámica por etiquetas.
    xlSortValues.Ordena el informe de tabla dinámica por valores.
  • 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.(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 una ordenación normal.
  • MatchCase
    Tipo: System.Object
    Es true para realizar una ordenación con distinción de mayúsculas y minúsculas; es false para realizar una ordenación sin esta distinción.No se puede utilizar cuando se ordenan informes de tabla dinámica.
  • 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.Criterio de ordenación fonética de los caracteres en chino.

Valor devuelto

Tipo: System.Object

Comentarios

La configuración de Header, Order1, Order2, Order3, OrderCustom y Orientation se guarda, para la hoja de cálculo en concreto, cada vez que se utilice este método. Si no especifica valores para estos argumentos, la próxima vez que realice una llamada al método se utilizarán los valores guardados. Establece explícitamente estos argumentos cada vez que se utilice este método, si decide no usar los valores guardados.

Se ordenan cadenas de texto que no son convertibles en datos numéricos normalmente.

Si no se define ningún argumento con este método, Microsoft Office Excel ordenará 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 siguiente ejemplo de código se coloca un conjunto de enteros en las celdas A1 a A5 y, a continuación, se utiliza el método Sort para ordenar los datos en orden ascendente.

Se trata de un ejemplo para una personalización en el nivel del documento.

    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", missing].Value2 = 30;
    this.Range["A2", missing].Value2 = 10;
    this.Range["A3", missing].Value2 = 20;
    this.Range["A4", missing].Value2 = 50;
    this.Range["A5", missing].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);
}

Seguridad de .NET Framework

Vea también

Referencia

NamedRange Interfaz

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