NamedRange.SortSpecial Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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.

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

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

Parametri

SortMethod: XlSortMethod

Tipo di ordinamento. Alcune di queste costanti potrebbero non essere disponibili per l'utente, a seconda del supporto linguistico (inglese statunitense, ad esempio) selezionato o installato. Può essere uno dei valori seguenti XlSortMethod : xlStroke. Applica l'ordinamento in base alla quantità di tratti in ciascun carattere. xlPinYin (predefinito). Ordinamento fonetico cinese per caratteri.

Key1: Object

Il primo campo di ordinamento, come testo (nome intervallo) o un Range oggetto ("Dept" o Cells(1, 1), ad esempio.

Order1: XlSortOrder

Ordine di ordinamento per il campo o l'intervallo specificato in Key1. Può essere uno dei valori seguenti XlSortOrder : xlDescending. Key1 Ordina in ordine decrescente. xlAscending (impostazione predefinita). Key1 Ordina in ordine crescente.

Type: Object

Specifica gli elementi da ordinare. Utilizzare questo argomento solo durante l'ordinamento di rapporti di tabella pivot.

Key2: Object

Secondo campo dell'ordinamento, come testo (nome di intervallo) o oggetto 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: XlSortOrder

Ordinamento per il campo o l'intervallo specificato nell'argomento Key2 . Impossibile usare quando si ordinano report di tabella pivot. Può essere uno dei valori seguenti XlSortOrder : xlDescending. Key2 Ordina in ordine decrescente. xlAscending (impostazione predefinita). Key2 Ordina in ordine crescente.

Key3: Object

Terzo campo dell'ordinamento, come testo (nome di intervallo) o oggetto 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: XlSortOrder

Ordinamento per il campo o l'intervallo specificato nell'argomento Key3 . Impossibile usare quando si ordinano report di tabella pivot. Può essere uno dei valori seguenti XlSortOrder : xlDescending. Key3 Ordina in ordine decrescente. xlAscending (impostazione predefinita). Key3 Ordina in ordine crescente.

Header: XlYesNoGuess

Specifica se la prima riga contiene o meno intestazioni. Impossibile usare quando si ordinano report di tabella pivot. Può essere uno dei valori seguenti 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: Object

Questo argomento è un offset di Integer in base uno rispetto all'elenco dei criteri di ordinamento personalizzati. Se si omette OrderCustom, viene usato l'ordine di ordinamento normale.

MatchCase: 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.

Orientation: XlSortOrientation

Orientamento dell'ordinamento. Può essere uno dei valori seguenti XlSortOrientation : xlSortRows (impostazione predefinita). L'ordinamento viene eseguito per riga. xlSortColumns. L'ordinamento viene eseguito per colonna.

DataOption1: XlSortDataOption

Specifica come ordinare il testo in key1. Impossibile usare quando si ordinano report di tabella pivot. Può essere uno dei valori seguenti XlSortDataOption : xlSortTextAsNumbers. Considera il testo come dati numerici ai fini dell'ordinamento. xlSortNormal (predefinito). Ordina separatamente dati numerici e di testo.

DataOption2: XlSortDataOption

Specifica come ordinare il testo in key2. Impossibile usare quando si ordinano report di tabella pivot. Può essere uno dei valori seguenti XlSortDataOption : xlSortTextAsNumbers. Considera il testo come dati numerici ai fini dell'ordinamento. xlSortNormal (predefinito). Ordina separatamente dati numerici e di testo.

DataOption3: XlSortDataOption

Specifica come ordinare il testo in key3. Impossibile usare quando si ordinano report di tabella pivot. Può essere uno dei valori seguenti XlSortDataOption : xlSortTextAsNumbers. Considera il testo come dati numerici ai fini dell'ordinamento. xlSortNormal (predefinito). Ordina separatamente dati numerici e di testo.

Restituisce

Object

Esempio

Nell'esempio di codice seguente viene usato il SortSpecial metodo per ordinare un NamedRange oggetto usando Pin Yin (ordinamento cinese fonetico per i caratteri). Per ordinare i caratteri cinesi, in questo esempio si presuppone che l'utente disponga del supporto linguistico cinese per Microsoft Office Excel. Excel verrà predefinito per ordinare il valore in base al NamedRange valore se l'utente non dispone del supporto per la lingua cinese.

Questo esempio è relativo a una personalizzazione a livello di documento.

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

}

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

Commenti

Se non vengono definiti argomenti con questo metodo, Microsoft Office Excel ordina la selezione in ordine crescente.

Parametri facoltativi

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

Si applica a

Condividi tramite