Sdílet prostřednictvím

NamedRange.Sort-Methode (2007 System)

  • Článek

Aktualisiert: November 2007

Sortiert die Daten in einem NamedRange-Steuerelement.

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

Syntax

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

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 ein Header vorhanden ist und wo sich dieser 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. Je nach der Sprachunterstützung (beispielsweise Englisch (USA)), die Sie ausgewählt oder installiert haben, stehen Ihnen möglicherweise einige dieser Konstanten nicht zur Verfügung.

    Kann einer der folgenden XlSortMethod-Werte sein:

    • xlStroke : Das Sortieren 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 Parametern in Office-Projektmappen.

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

Berechtigungen

Siehe auch

Referenz

NamedRange-Klasse

NamedRange-Member

Microsoft.Office.Tools.Excel-Namespace