NamedRange.Sort Methode

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Excel

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

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Sortiert die Daten in einem NamedRange-Steuerelement.

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

Parameter

Key1: Object

Das erste Sortierfeld, entweder als Text (bereichsname) oder als Range Objekt ("Dept" oder Cells(1, 1), z. B.

Order1: XlSortOrder

Die Sortierreihenfolge für das in Key1angegebene Feld oder Bereich. Dies kann einer der folgenden XlSortOrder Werte sein: xlDescending. Sortiert Key1 in absteigender Reihenfolge. xlAscending. Sortiert Key1 in aufsteigender Reihenfolge.

Key2: Object

Das zweite Sortierfeld, entweder als Text (ein Bereichsname) oder als Range-Objekt. Wenn Sie dieses Argument weglassen, ist kein zweites Sortierfeld vorhanden.

Type: Object

Gibt die zu sortierenden Elemente an. Verwenden Sie dieses Argument nur beim Sortieren von PivotTable-Berichten. Dies kann einer der folgenden XlSortType Werte sein: xlSortLabels. Sortiert den PivotTable-Bericht nach Bezeichnungen. xlSortValues. Sortiert den PivotTable-Bericht nach Werten.

Order2: XlSortOrder

Die Sortierreihenfolge für den in Key2angegebenen Bereich. Beim Sortieren von PivotTable-Berichten kann nicht verwendet werden. Dies kann einer der folgenden XlSortOrder Werte sein: xlDescending. Sortiert Key2 in absteigender Reihenfolge. xlAscending. Sortiert Key2 in aufsteigender Reihenfolge.

Key3: Object

Das dritte Sortierfeld, entweder als Text (ein Bereichsname) oder als Range-Objekt. Wenn Sie dieses Argument weglassen, ist kein drittes Sortierfeld vorhanden. Kann nicht beim Sortieren von PivotTable-Berichten verwendet werden.

Order3: XlSortOrder

Die Sortierreihenfolge für das in Key3angegebene Feld oder Bereich. Beim Sortieren von PivotTable-Berichten kann nicht verwendet werden. Dies kann einer der folgenden XlSortOrder Werte sein: xlDescending. Sortiert Key3 in absteigender Reihenfolge. xlAscending. Sortiert Key3 in aufsteigender Reihenfolge.

Header: XlYesNoGuess

Gibt an, ob die erste Zeile Header enthält oder nicht. Beim Sortieren von PivotTable-Berichten kann nicht verwendet werden. Dies 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: Object

Dieses Argument ist ein mit eins beginnender Ganzzahloffset, der sich auf die Liste der benutzerdefinierten Sortierreihenfolgen bezieht. Wenn Sie weglassen OrderCustom, wird eine normale Sortierung verwendet.

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

Orientation: XlSortOrientation

Die Sortierausrichtung. Dies kann einer der folgenden XlSortOrientation Werte sein: xlSortRows. Sortiert nach Zeile. xlSortColumns. Sortiert nach Spalte.

SortMethod: XlSortMethod

Der Sortiertyp. Einige dieser Konstanten stehen Ihnen möglicherweise nicht zur Verfügung, abhängig von der Sprachunterstützung (z. B. US-Englisch), die Sie ausgewählt oder installiert haben. Dies kann einer der folgenden XlSortMethod Werte sein: xlStroke. Sortiert nach der Anzahl von Strichen in jedem Zeichen. xlPinYin. Phonetische chinesische Sortierreihenfolge für Zeichen.

DataOption1: XlSortDataOption

Gibt an, wie Text in key1sortiert wird. Beim Sortieren von PivotTable-Berichten kann nicht verwendet werden. Dies kann einer der folgenden XlSortDataOption Werte sein: xlSortTextAsNumbers. Behandelt Text beim Sortieren wie numerische Daten. xlSortNormal. Sortiert numerische Daten und Textdaten getrennt.

DataOption2: XlSortDataOption

Gibt an, wie Text in key2sortiert wird. Beim Sortieren von PivotTable-Berichten kann nicht verwendet werden. Dies kann einer der folgenden XlSortDataOption Werte sein: xlSortTextAsNumbers. Behandelt Text beim Sortieren wie numerische Daten. xlSortNormal. Sortiert numerische Daten und Textdaten getrennt.

DataOption3: XlSortDataOption

Gibt an, wie Text in key3sortiert wird. Beim Sortieren von PivotTable-Berichten kann nicht verwendet werden. Dies kann einer der folgenden XlSortDataOption Werte sein: xlSortTextAsNumbers. Behandelt Text beim Sortieren wie numerische Daten. xlSortNormal. Sortiert numerische Daten und Textdaten getrennt.

Gibt zurück

Object

Beispiele

Im folgenden Codebeispiel wird eine Reihe von ganzen Zahlen in den Zellen A1 bis A5 platziert. Anschließend wird die Sort -Methode verwendet, um die Daten in aufsteigender Reihenfolge zu sortieren.

Dieses Beispiel gilt für eine Anpassung auf Dokumentebene.

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

Hinweise

Die Einstellungen für Header, , Order2Order1, Order3, OrderCustom, und Orientation werden für das jeweilige Arbeitsblatt bei jeder Verwendung dieser Methode gespeichert. Wenn Sie beim nächsten Aufruf der -Methode keine Werte für diese Argumente angeben, werden die gespeicherten Werte verwendet. Legen Sie diese Argumente bei jeder Verwendung dieser Methode explizit fest, wenn Sie die gespeicherten Werte nicht verwenden möchten.

Textzeichenfolgen, die nicht in numerische Daten konvertiert werden können, werden normal sortiert.

Wenn mit dieser Methode keine Argumente definiert sind, sortiert Microsoft Office Excel die Auswahl in aufsteigender Reihenfolge.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Projektmappen.

Gilt für:

Freigeben über