Share via

Metodo NamedRange.Sort

  • Articolo

Ordina i dati in un controllo NamedRange.

Spazio dei nomi:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
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
)

Parametri

  • Type
    Tipo: System.Object
    Specifica gli elementi da ordinare.Utilizzare questo argomento solo durante l'ordinamento di rapporti di tabella pivot.
    Può essere uno dei seguenti valori di XlSortType:
    xlSortLabels.Ordina il rapporto di tabella pivot in base alle etichette.
    xlSortValues.Ordina il rapporto di tabella pivot in base ai valori.
  • Key3
    Tipo: System.Object
    Terzo campo dell'ordinamento, come testo (nome di intervallo) o oggetto Microsoft.Office.Interop.Excel.Range.Se si omette questo argomento, non sarà disponibile un terzo campo di ordinamento.Non può essere utilizzato durante l'ordinamento di rapporti di tabella pivot.
  • Header
    Tipo: Microsoft.Office.Interop.Excel.XlYesNoGuess
    Specifica se la prima riga contiene o meno intestazioni.Non può essere utilizzato durante l'ordinamento di rapporti di tabella pivot.
    Può essere uno dei seguenti valori di XlYesNoGuess:
    xlGuess.Consente di determinare automaticamente l'eventuale esistenza di un'intestazione e la relativa posizione.
    xlNo.L'intero intervallo deve essere ordinato.
    xlYes.L'intero intervallo non deve essere ordinato.
  • OrderCustom
    Tipo: System.Object
    Questo argomento è un offset di Integer in base uno rispetto all'elenco dei criteri di ordinamento personalizzati.Se si omette OrderCustom, verrà eseguito un normale ordinamento.
  • MatchCase
    Tipo: System.Object
    true per eseguire un ordinamento rilevando la distinzione tra maiuscole e minuscole; false per eseguire un ordinamento senza rilevare la distinzione tra maiuscole e minuscole.Non può essere utilizzato durante l'ordinamento di rapporti di tabella pivot.
  • SortMethod
    Tipo: Microsoft.Office.Interop.Excel.XlSortMethod
    Tipo di ordinamento.Alcune di queste costanti potrebbero non essere disponibili per la lingua selezionata o installata,inglese, ad esempio) selezionato o installato.
    Può essere uno dei seguenti valori di XlSortMethod:
    xlStroke.Applica l'ordinamento in base alla quantità di tratti in ciascun carattere.
    xlPinYin.Ordinamento fonetico cinese per caratteri.

Valore restituito

Tipo: System.Object

Note

Le impostazioni dei parametri Header, Order1, Order2, Order3, OrderCustom e Orientation per il foglio di lavoro specifico vengono salvate ogni volta che si utilizza questo metodo. Se non si specificano i valori per questi argomenti, per la successiva chiamata al metodo saranno utilizzati i valori salvati. Se non si desidera utilizzare i valori salvati, sarà necessario impostare gli argomenti in modo esplicito ogni volta che si utilizza questo metodo.

Le stringhe di testo che non possono essere convertite in dati numerici vengono ordinate normalmente.

Se non vengono definiti argomenti per questo metodo, verrà applicato automaticamente l'ordinamento crescente.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice riportato di seguito viene inserito un set di numeri interi nell'intervallo di celle da A1 a A5, viene quindi utilizzato il metodo Sort per applicare ai dati l'ordinamento crescente.

Questo esempio è valido per una personalizzazione a livello di 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);
}

Sicurezza di .NET Framework

Vedere anche

Riferimenti

NamedRange Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel