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

Ordina i dati in un controllo 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

Parametri

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. Key1 Ordina in ordine crescente.

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.

Type: Object

Specifica gli elementi da ordinare. Usare questo argomento solo quando si ordinano report di tabella pivot. Può essere uno dei valori seguenti XlSortType : xlSortLabels. Ordina il rapporto di tabella pivot in base alle etichette. xlSortValues. Ordina il rapporto di tabella pivot in base ai valori.

Order2: XlSortOrder

Ordine di ordinamento per l'intervallo specificato in Key2. Impossibile usare quando si ordinano report di tabella pivot. Può essere uno dei valori seguenti XlSortOrder : xlDescending. Key2 Ordina in ordine decrescente. xlAscending. 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

Ordine di ordinamento per il campo o l'intervallo specificato in Key3. Impossibile usare quando si ordinano report di tabella pivot. Può essere uno dei valori seguenti XlSortOrder : xlDescending. Key3 Ordina in ordine decrescente. xlAscending. 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. 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 un normale ordinamento.

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. Applica l'ordinamento per riga. xlSortColumns. Applica l'ordinamento per colonna.

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. Ordinamento fonetico cinese per caratteri.

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. 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. 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. Ordina separatamente dati numerici e di testo.

Restituisce

Object

Esempio

L'esempio di codice seguente inserisce un set di interi nelle celle A1 a A5 e quindi usa il Sort metodo per ordinare i dati in ordine crescente.

Questo esempio è relativo a una personalizzazione a livello di 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

Commenti

Le impostazioni per Header, Order1OrderCustomOrder2Order3e Orientation vengono salvate, per il foglio di lavoro specifico, ogni volta che si usa questo metodo. Se non si specificano i valori per questi argomenti la volta successiva che si chiama il metodo, vengono usati i valori salvati. Impostare questi argomenti in modo esplicito ogni volta che si usa questo metodo, se si sceglie di non usare i valori salvati.

Le stringhe di testo che non sono convertibili in dati numerici vengono ordinate normalmente.

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