Freigeben über


NamedRange.Sort-Methode

Sortiert die Daten in einem NamedRange-Steuerelement.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

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

Parameter

  • Type
    Typ: System.Object
    Gibt die zu sortierenden Elemente an.Verwenden Sie dieses Argument nur beim Sortieren von PivotTable-Berichten.
    Kann einer der folgenden XlSortType-Werte sein:
    xlSortLabels .Sortiert den PivotTable-Bericht nach Bezeichnungen.
    xlSortValues .Sortiert den PivotTable-Bericht nach Werten.
  • Key3
    Typ: System.Object
    Das dritte Sortierfeld, entweder als Text (ein Bereichsname) oder als Microsoft.Office.Interop.Excel.Range-Objekt.Wenn Sie dieses Argument weglassen, ist kein drittes Sortierfeld vorhanden.Kann nicht beim Sortieren von PivotTable-Berichten verwendet werden.
  • Header
    Typ: Microsoft.Office.Interop.Excel.XlYesNoGuess
    Gibt an, ob die erste Zeile Header enthält oder nicht.Kann nicht beim Sortieren von PivotTable-Berichten verwendet werden.
    Kann einer der folgenden XlYesNoGuess-Werte sein:
    xlGuess .Lässt Microsoft Office Excel bestimmen, ob eine Kopfzeile vorhanden ist und wo sich diese befindet.
    xlNo .(Der gesamte Bereich soll sortiert werden.)
    xlYes .(Der gesamte Bereich soll nicht sortiert werden.)
  • OrderCustom
    Typ: System.Object
    Dieses Argument ist ein mit eins beginnender Ganzzahloffset, der sich auf die Liste der benutzerdefinierten Sortierreihenfolgen bezieht.Wenn Sie OrderCustom weglassen, wird eine normale Sortierung verwendet.
  • MatchCase
    Typ: System.Object
    true , um bei der Sortierung die Groß-/Kleinschreibung zu berücksichtigen, und false, wenn bei der Sortierung die Groß-/Kleinschreibung nicht berücksichtigt werden soll.Kann nicht beim Sortieren von PivotTable-Berichten verwendet werden.
  • SortMethod
    Typ: Microsoft.Office.Interop.Excel.XlSortMethod
    Der Sortiertyp.Einige dieser Konstanten sind möglicherweise nicht verfügbar, je nach Sprachunterstützung (z. B. U.S.-Englisch), die ausgewählt oder installiert wurde.
    Kann einer der folgenden XlSortMethod-Werte sein:
    xlStroke .Sortiert nach der Anzahl von Strichen in jedem Zeichen.
    xlPinYin .Phonetische chinesische Sortierreihenfolge für Zeichen.

Rückgabewert

Typ: System.Object

Hinweise

Die Einstellungen für Header, Order1, Order2, Order3, OrderCustom und Orientation werden für das jeweilige Arbeitsblatt bei jeder Verwendung dieser Methode gespeichert.Wenn Sie für diese Argumente keine Werte angeben, werden beim nächsten Aufrufen der Methode die gespeicherten Werte verwendet.Falls Sie die gespeicherten Werte nicht verwenden möchten, sollten Sie diese Argumente jedes Mal explizit festlegen, wenn Sie diese Methode verwenden.

Textzeichenfolgen, die nicht in numerische Daten umgewandelt werden können, werden mit normaler Sortierung sortiert.

Wenn beim Aufruf der Methode keine Argumente definiert werden, sortiert Microsoft Office Excel die Auswahl in aufsteigender Reihenfolge.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird eine Menge von ganzen Zahlen in die Zellen A1 bis A5 platziert. Anschließend werden die Daten mithilfe der Sort-Methode in aufsteigender Reihenfolge sortiert.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

    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"].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);
}

.NET Framework-Sicherheit

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace