NamedRange.SortSpecial-Methode

  • Artikel

Verwendet beim Sortieren des NamedRange-Steuerelements ostasiatische Sortiermethoden. So wird beispielsweise Japanisch in der Reihenfolge der Kana-Silbenschrift sortiert. Weitere Informationen finden Sie im Abschnitt zur Parameterliste.

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

Syntax

'Declaration
Function SortSpecial ( _
    SortMethod As XlSortMethod, _
    Key1 As Object, _
    Order1 As XlSortOrder, _
    Type As Object, _
    Key2 As Object, _
    Order2 As XlSortOrder, _
    Key3 As Object, _
    Order3 As XlSortOrder, _
    Header As XlYesNoGuess, _
    OrderCustom As Object, _
    MatchCase As Object, _
    Orientation As XlSortOrientation, _
    DataOption1 As XlSortDataOption, _
    DataOption2 As XlSortDataOption, _
    DataOption3 As XlSortDataOption _
) As Object

Object SortSpecial(
    XlSortMethod SortMethod,
    Object Key1,
    XlSortOrder Order1,
    Object Type,
    Object Key2,
    XlSortOrder Order2,
    Object Key3,
    XlSortOrder Order3,
    XlYesNoGuess Header,
    Object OrderCustom,
    Object MatchCase,
    XlSortOrientation Orientation,
    XlSortDataOption DataOption1,
    XlSortDataOption DataOption2,
    XlSortDataOption DataOption3
)

Parameter

  • SortMethod
    Typ: Microsoft.Office.Interop.Excel.XlSortMethod
    Der Sortiertyp.Einige dieser Konstanten sind möglicherweise nicht verfügbar, je nach der Sprachunterstützung (beispielsweise Englisch (USAbeispielsweise 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.Sortiert nach der Anzahl von Strichen in jedem Zeichen.
    xlPinYin (Standardwert).Phonetische chinesische Sortierreihenfolge für Zeichen.
  • Type
    Typ: System.Object
    Gibt die zu sortierenden Elemente an.Verwenden Sie dieses Argument nur beim Sortieren von PivotTable-Berichten.
  • Key2
    Typ: System.Object
    Das zweite Sortierfeld, entweder als Text (ein Bereichsname) oder als Microsoft.Office.Interop.Excel.Range-Objekt.Wenn Sie dieses Argument weglassen, ist kein zweites Sortierfeld vorhanden.Kann nicht beim Sortieren von PivotTable-Berichten verwendet werden.
  • Order2
    Typ: Microsoft.Office.Interop.Excel.XlSortOrder
    Die Sortierreihenfolge für das Feld oder den Bereich, der im Key2-Argument angegeben wird.Kann nicht beim Sortieren von PivotTable-Berichten verwendet werden.
    Kann einer der folgenden XlSortOrder-Werte sein:
    xlDescending.Sortiert Key2 in absteigender Reihenfolge.
    xlAscending (Standardwert).Sortiert Key2 in aufsteigender Reihenfolge.
  • 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.
  • Order3
    Typ: Microsoft.Office.Interop.Excel.XlSortOrder
    Die Sortierreihenfolge für das Feld oder den Bereich, der im Key3-Argument angegeben wird.Kann nicht beim Sortieren von PivotTable-Berichten verwendet werden.
    Kann einer der folgenden XlSortOrder-Werte sein:
    xlDescending.Sortiert Key3 in absteigender Reihenfolge.
    xlAscending (Standardwert).Sortiert Key3 in aufsteigender Reihenfolge.
  • 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 (Standardwert).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 die normale Sortierreihenfolge 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.

Rückgabewert

Typ: System.Object

Hinweise

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 Beispiel wird die SortSpecial-Methode verwendet, um einen NamedRange unter Verwendung von Pin Yin (phonetische chinesische Sortierreihenfolge für Zeichen) zu sortieren. Um chinesische Zeichen sortieren zu können, wird in diesem Beispiel davon ausgegangen, dass der Benutzer chinesische Sprachunterstützung für Microsoft Office Excel installiert hat. Wenn der Benutzer nicht über chinesische Sprachunterstützung verfügt, sortiert Excel den NamedRange standardmäßig nach Wert.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

    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


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

.NET Framework-Sicherheit

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace