Share via

Metodo NamedRange.SortSpecial

  • Articolo

Utilizza i metodi di ordinamento dell'Asia orientale per ordinare il controllo NamedRange. Nella lingua Giapponese, ad esempio, ai fini dell'ordinamento viene utilizzato il sillabario Kana. Per ulteriori informazioni, vedere l'elenco dei parametri.

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

Sintassi

'Dichiarazione
Function SortSpecial ( _
    SortMethod As XlSortMethod, _
    Key1 As Object, _
    Order1 As XlSortOrder, _
    Type As Object, _
    Key2 As Object, _
    Order2 As XlSortOrder, _
    Key3 As Object, _
    Order3 As XlSortOrder, _
    Header As XlYesNoGuess, _
    OrderCustom As Object, _
    MatchCase As Object, _
    Orientation As XlSortOrientation, _
    DataOption1 As XlSortDataOption, _
    DataOption2 As XlSortDataOption, _
    DataOption3 As XlSortDataOption _
) As Object

Object SortSpecial(
    XlSortMethod SortMethod,
    Object Key1,
    XlSortOrder Order1,
    Object Type,
    Object Key2,
    XlSortOrder Order2,
    Object Key3,
    XlSortOrder Order3,
    XlYesNoGuess Header,
    Object OrderCustom,
    Object MatchCase,
    XlSortOrientation Orientation,
    XlSortDataOption DataOption1,
    XlSortDataOption DataOption2,
    XlSortDataOption DataOption3
)

Parametri

  • 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 (predefinito).Ordinamento fonetico cinese per caratteri.
  • Type
    Tipo: System.Object
    Specifica gli elementi da ordinare.Utilizzare questo argomento solo durante l'ordinamento di rapporti di tabella pivot.
  • Key2
    Tipo: System.Object
    Secondo campo dell'ordinamento, come testo (nome di intervallo) o oggetto Microsoft.Office.Interop.Excel.Range.Se si omette questo argomento, non sarà disponibile un secondo campo di ordinamento.Non può essere utilizzato durante l'ordinamento di rapporti di tabella pivot.
  • Order2
    Tipo: Microsoft.Office.Interop.Excel.XlSortOrder
    Ordinamento per il campo o l'intervallo specificato nell'argomento Key2.Non può essere utilizzato durante l'ordinamento di rapporti di tabella pivot.
    Può essere uno dei seguenti valori di XlSortOrder:
    xlDescending.Applica l'ordinamento decrescente a Key2.
    xlAscending (predefinito).Applica a Key2 l'ordinamento crescente.
  • 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.
  • Order3
    Tipo: Microsoft.Office.Interop.Excel.XlSortOrder
    Ordinamento per il campo o l'intervallo specificato nell'argomento Key3.Non può essere utilizzato durante l'ordinamento di rapporti di tabella pivot.
    Può essere uno dei seguenti valori di XlSortOrder:
    xlDescending.Applica l'ordinamento decrescente a Key3.
    xlAscending (predefinito).Applica a Key3 l'ordinamento crescente.
  • 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 (predefinito).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.

Valore restituito

Tipo: System.Object

Note

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 utilizzato il metodo SortSpecial per ordinare un oggetto NamedRange utilizzando l'ordinamento Pin Yin, ovvero l'ordinamento fonetico cinese per caratteri. Per ordinare i caratteri cinesi, si presuppone che sia installato il supporto della lingua Cinese per Microsoft Office Excel. Se l'utente non dispone del supporto della lingua Cinese, per impostazione predefinita, l'ordinamento di NamedRange verrà eseguito in base ai valori.

Questo esempio è valido per una personalizzazione a livello di documento.

    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


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

Sicurezza di .NET Framework

Vedere anche

Riferimenti

NamedRange Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel