NamedRange.SortSpecial-Methode
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 Sprachunterstützung (z. B. U.S.-Englisch), die ausgewählt oder installiert wurde.
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
Typ: System.Object
Das erste Sortierfeld, entweder als Text (ein Bereichsname) oder als Microsoft.Office.Interop.Excel.Range-Objekt (beispielsweise "Dept" oder Cells(1, 1)).
- Order1
Typ: Microsoft.Office.Interop.Excel.XlSortOrder
Die Sortierreihenfolge für das Feld oder den Bereich, der in Key1 angegeben wird.
Kann einer der folgenden XlSortOrder-Werte sein:
xlDescending .Sortiert Key1 in absteigender Reihenfolge.
xlAscending (Standardwert).Sortiert Key1 in aufsteigender Reihenfolge.
- 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.
- Orientation
Typ: Microsoft.Office.Interop.Excel.XlSortOrientation
Die Ausrichtung der Sortierung.
Kann einer der folgenden XlSortOrientation-Werte sein:
xlSortRows (Standardwert).Die Sortierung erfolgt nach Zeile.
xlSortColumns .Die Sortierung erfolgt nach Spalte.
- DataOption1
Typ: Microsoft.Office.Interop.Excel.XlSortDataOption
Gibt an, wie Text in key1 sortiert wird.Kann nicht beim Sortieren von PivotTable-Berichten 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
Typ: Microsoft.Office.Interop.Excel.XlSortDataOption
Gibt an, wie Text in key2 sortiert wird.Kann nicht beim Sortieren von PivotTable-Berichten 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
Typ: Microsoft.Office.Interop.Excel.XlSortDataOption
Gibt an, wie Text in key3 sortiert wird.Kann nicht beim Sortieren von PivotTable-Berichten 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.
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"].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);
}
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.