NamedRange.Sort 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í.

Ordena los datos en un control NamedRange.

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

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

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 para el campo o intervalo especificado en Key1. Puede ser uno de los siguientes XlSortOrder valores: xlDescending. Ordena Key1 en orden descendente. xlAscending. Ordena Key1 en orden ascendente.

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.

Type: Object

Especifica qué elementos se van a ordenar. Use este argumento solo al ordenar informes de tabla dinámica. Puede ser uno de los siguientes XlSortType valores: xlSortLabels. Ordena el informe de tabla dinámica por etiquetas. xlSortValues. Ordena el informe de tabla dinámica por valores.

Order2: XlSortOrder

Criterio de ordenación del intervalo especificado en Key2. No se puede usar al ordenar informes de tabla dinámica. Puede ser uno de los siguientes XlSortOrder valores: xlDescending. Ordena Key2 en orden descendente. xlAscending. 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 para el campo o intervalo especificado en Key3. No se puede usar al ordenar informes de tabla dinámica. Puede ser uno de los siguientes XlSortOrder valores: xlDescending. Ordena Key3 en orden descendente. xlAscending. 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 siguientes XlYesNoGuess valores: 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: 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 una 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 siguientes XlSortOrientation valores: xlSortRows. Ordena por fila. xlSortColumns. Ordena por columna.

SortMethod: XlSortMethod

Tipo de ordenación. Es posible que algunas de estas constantes no estén disponibles, según la compatibilidad con el idioma (por ejemplo, inglés de EE. UU.) que haya seleccionado o instalado. Puede ser uno de los siguientes XlSortMethod valores: xlStroke. Ordenación por la cantidad de trazos de cada carácter. xlPinYin. Criterio de ordenación fonética de los caracteres en chino.

DataOption1: XlSortDataOption

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

DataOption2: XlSortDataOption

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

DataOption3: XlSortDataOption

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

Devoluciones

Object

Ejemplos

En el ejemplo de código siguiente se coloca un conjunto de enteros en las celdas A1 a A5 y, a continuación, se usa el Sort método para ordenar los datos en orden ascendente.

Este ejemplo es para una personalización de nivel de documento.

private void SortNamedRange()
{
    // Set some data in a range of cells.
    this.Range["A1"].Value2 = 30;
    this.Range["A2"].Value2 = 10;
    this.Range["A3"].Value2 = 20;
    this.Range["A4"].Value2 = 50;
    this.Range["A5"].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);
}

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

Comentarios

La configuración de Header, Order1, Order2, Order3, OrderCustomy Orientation se guarda para la hoja de cálculo determinada cada vez que se usa este método. Si no especifica valores para estos argumentos la próxima vez que llame al método , se usarán los valores guardados. Establezca estos argumentos explícitamente cada vez que use este método, si decide no usar los valores guardados.

Las cadenas de texto que no se pueden convertir en datos numéricos se ordenan 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 los parámetros opcionales, vea Parámetros opcionales en soluciones de Office.

Se aplica a

Compartir a través de