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

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.

public object SortSpecial (Microsoft.Office.Interop.Excel.XlSortMethod SortMethod = Microsoft.Office.Interop.Excel.XlSortMethod.xlPinYin, object Key1, Microsoft.Office.Interop.Excel.XlSortOrder Order1 = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, object Type, object Key2, 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.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 SortSpecial : Microsoft.Office.Interop.Excel.XlSortMethod * 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.XlSortDataOption * Microsoft.Office.Interop.Excel.XlSortDataOption * Microsoft.Office.Interop.Excel.XlSortDataOption -> obj

Public Function SortSpecial (Optional SortMethod As XlSortMethod = Microsoft.Office.Interop.Excel.XlSortMethod.xlPinYin, Optional Key1 As Object, Optional Order1 As XlSortOrder = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, Optional Type As Object, Optional Key2 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 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

SortMethod: XlSortMethod

Der Sortiertyp. Einige dieser Konstanten stehen Ihnen möglicherweise nicht zur Verfügung, abhängig von der Sprachunterstützung (z. B. ENGLISCH in den USA), die Sie ausgewählt oder installiert haben. 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.

Key1: Object

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

Order1: XlSortOrder

Die Sortierreihenfolge für das feld oder den bereich, die in angegeben ist Key1. Kann einer der folgenden XlSortOrder Werte sein: xlDescending. Key1 Sortiert in absteigender Reihenfolge. xlAscending (Standard). Key1 Sortiert in aufsteigender Reihenfolge.

Type: Object

Gibt die zu sortierenden Elemente an. Verwenden Sie dieses Argument nur beim Sortieren von PivotTable-Berichten.

Key2: Object

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

Order2: XlSortOrder

Die Sortierreihenfolge für das im Argument angegebene Feld oder Bereich Key2 . Beim Sortieren von PivotTable-Berichten kann nicht verwendet werden. Kann einer der folgenden XlSortOrder Werte sein: xlDescending. Key2 Sortiert in absteigender Reihenfolge. xlAscending (Standard). Key2 Sortiert 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 im Argument angegebene Feld oder Bereich Key3 . Beim Sortieren von PivotTable-Berichten kann nicht verwendet werden. Kann einer der folgenden XlSortOrder Werte sein: xlDescending. Key3 Sortiert in absteigender Reihenfolge. xlAscending (Standard). Key3 Sortiert 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. 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: Object

Dieses Argument ist ein mit eins beginnender Ganzzahloffset, der sich auf die Liste der benutzerdefinierten Sortierreihenfolgen bezieht. Wenn Sie weglassen OrderCustom, wird die normale Sortierreihenfolge 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. Kann einer der folgenden XlSortOrientation Werte sein: xlSortRows (Standard). Die Sortierung erfolgt nach Zeile. xlSortColumns. Die Sortierung erfolgt nach Spalte.

DataOption1: XlSortDataOption

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

DataOption2: XlSortDataOption

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

DataOption3: XlSortDataOption

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

Gibt zurück

Object

Beispiele

Im folgenden Codebeispiel wird die SortSpecial -Methode verwendet, um eine NamedRange mithilfe von Pin Yin (phonetische chinesische Sortierreihenfolge für Zeichen) zu sortieren. Um chinesische Zeichen zu sortieren, wird in diesem Beispiel davon ausgegangen, dass der Benutzer chinesische Sprachunterstützung für Microsoft Office Excel hat. Excel sortiert standardmäßig den NamedRange Wert nach dem Wert, wenn der Benutzer keine Chinesische Sprachunterstützung hat.

Dieses Beispiel gilt für eine Anpassung auf Dokumentebene.

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

}

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

Hinweise

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