Metodo NamedRange.Sort (System 2007)

  • Articolo

Aggiornamento: novembre 2007

Ordina i dati in un controllo NamedRange.

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

Sintassi

Public 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

Dim instance As NamedRange
Dim Key1 As Object
Dim Order1 As XlSortOrder
Dim Key2 As Object
Dim Type As Object
Dim Order2 As XlSortOrder
Dim Key3 As Object
Dim Order3 As XlSortOrder
Dim Header As XlYesNoGuess
Dim OrderCustom As Object
Dim MatchCase As Object
Dim Orientation As XlSortOrientation
Dim SortMethod As XlSortMethod
Dim DataOption1 As XlSortDataOption
Dim DataOption2 As XlSortDataOption
Dim DataOption3 As XlSortDataOption
Dim returnValue As Object

returnValue = instance.Sort(Key1, Order1, _
    Key2, Type, Order2, Key3, Order3, Header, _
    OrderCustom, MatchCase, Orientation, _
    SortMethod, DataOption1, DataOption2, _
    DataOption3)

public 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 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 costanti potrebbero non essere disponibili per la lingua selezionata o installata, ad esempio l'italiano.

    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 Informazioni sui parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice riportato di seguito viene inserita una serie di valori integer 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);
}

Autorizzazioni

Vedere anche

Riferimenti

NamedRange Classe

Membri NamedRange

Spazio dei nomi Microsoft.Office.Tools.Excel