NamedRange.SortSpecial Methode
Definition
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 key1
sortiert 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 key2
sortiert 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 key3
sortiert 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
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.