NamedRange.SortSpecial Metoda

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.Office.Tools.Excel

Zestaw:: Microsoft.Office.Tools.Excel.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Używa metod sortowania Wschodnioazjatyckie do sortowania kontrolki NamedRange . Na przykład japoński sortuje w kolejności sylabarnej Kana. Aby uzyskać więcej informacji, zobacz listę parametrów.

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

Parametry

SortMethod: XlSortMethod

Typ sortowania. Niektóre z tych stałych mogą nie być dostępne dla Ciebie, w zależności od obsługi języka (na przykład w języku angielskim w Stanach Zjednoczonych), które zostały wybrane lub zainstalowane. Może być jedną z następujących XlSortMethod wartości: xlStroke. Sortowanie według liczby pociągnięć w każdym znaku. xlPinYin (ustawienie domyślne). Fonetyczna chińska kolejność sortowania znaków.

Key1: Object

Pierwsze pole sortowania jako tekst (nazwa zakresu) lub Range obiekt ("Dept" lub Cells(1, 1), na przykład).

Order1: XlSortOrder

Kolejność sortowania dla pola lub zakresu określonego w elem. Key1 Może być jedną z następujących XlSortOrder wartości: xlDescending. Sortuje Key1 w kolejności malejącej. xlAscending (ustawienie domyślne). Sortuje Key1 w kolejności rosnącej.

Type: Object

Określa, które elementy mają być sortowane. Tego argumentu należy używać tylko podczas sortowania raportów w formie tabeli przestawnej.

Key2: Object

Drugie pole sortowania jako tekst (nazwa zakresu) lub Range obiekt. Jeśli pominiesz ten argument, nie ma drugiego pola sortowania. Nie można wykorzystywać podczas sortowania raportów tabel przestawnych.

Order2: XlSortOrder

Kolejność sortowania dla pola lub zakresu określonego w argumencie Key2 . Nie można używać podczas sortowania raportów w formie tabeli przestawnej. Może być jedną z następujących XlSortOrder wartości: xlDescending. Sortuje Key2 w kolejności malejącej. xlAscending (ustawienie domyślne). Sortuje Key2 w kolejności rosnącej.

Key3: Object

Trzecie pole sortowania jako tekst (nazwa zakresu) lub Range obiekt. Jeśli pominiesz ten argument, nie ma trzeciego pola sortowania. Nie można wykorzystywać podczas sortowania raportów tabel przestawnych.

Order3: XlSortOrder

Kolejność sortowania dla pola lub zakresu określonego w argumencie Key3 . Nie można używać podczas sortowania raportów w formie tabeli przestawnej. Może być jedną z następujących XlSortOrder wartości: xlDescending. Sortuje Key3 w kolejności malejącej. xlAscending (ustawienie domyślne). Sortuje Key3 w kolejności rosnącej.

Header: XlYesNoGuess

Określa, czy pierwszy wiersz zawiera nagłówki. Nie można używać podczas sortowania raportów w formie tabeli przestawnej. Może być jedną z następujących XlYesNoGuess wartości: xlGuess. Umożliwia programowi Microsoft Office Excel określenie, czy istnieje nagłówek, i określenie, gdzie jest, jeśli istnieje. xlNo (ustawienie domyślne). Cały zakres powinien zostać posortowany. xlYes. Nie należy sortować całego zakresu.

OrderCustom: Object

Ten argument jest jednokierunkowym przesunięciem liczb całkowitych na listę niestandardowych zamówień sortowania. Jeśli pominięto OrderCustom, używana jest normalna kolejność sortowania.

MatchCase: Object

true do sortowania z uwzględnieniem wielkości liter; false aby wykonać sortowanie, które nie uwzględnia wielkości liter. Nie można wykorzystywać podczas sortowania raportów tabel przestawnych.

Orientation: XlSortOrientation

Orientacja sortowania. Może być jedną z następujących XlSortOrientation wartości: xlSortRows (wartość domyślna). Sortowanie odbywa się według wiersza. xlSortColumns. Sortowanie odbywa się według kolumny.

DataOption1: XlSortDataOption

Określa sposób sortowania tekstu w pliku key1. Nie można używać podczas sortowania raportów w formie tabeli przestawnej. Może być jedną z następujących XlSortDataOption wartości: xlSortTextAsNumbers. Traktuje tekst jako dane liczbowe do sortowania. xlSortNormal (ustawienie domyślne). Sortuje oddzielnie dane liczbowe i tekstowe.

DataOption2: XlSortDataOption

Określa sposób sortowania tekstu w pliku key2. Nie można używać podczas sortowania raportów w formie tabeli przestawnej. Może być jedną z następujących XlSortDataOption wartości: xlSortTextAsNumbers. Traktuje tekst jako dane liczbowe do sortowania. xlSortNormal (ustawienie domyślne). Sortuje oddzielnie dane liczbowe i tekstowe.

DataOption3: XlSortDataOption

Określa sposób sortowania tekstu w pliku key3. Nie można używać podczas sortowania raportów w formie tabeli przestawnej. Może być jedną z następujących XlSortDataOption wartości: xlSortTextAsNumbers. Traktuje tekst jako dane liczbowe do sortowania. xlSortNormal (ustawienie domyślne). Sortuje oddzielnie dane liczbowe i tekstowe.

Zwraca

Object

Przykłady

W poniższym przykładzie kodu użyto SortSpecial metody do sortowania NamedRange przy użyciu numeru Pin Yin (fonetyczny chiński kolejność sortowania dla znaków). Aby posortować znaki w języku chińskim, w tym przykładzie przyjęto założenie, że użytkownik ma obsługę języka chińskiego dla programu Microsoft Office Excel. Program Excel domyślnie sortuje według NamedRange wartości, jeśli użytkownik nie obsługuje języka chińskiego.

Ten przykład dotyczy dostosowywania na poziomie dokumentu.

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

Uwagi

Jeśli w tej metodzie nie zdefiniowano żadnych argumentów, program Microsoft Office Excel sortuje wybór w kolejności rosnącej.

Parametry opcjonalne

Aby uzyskać informacje na temat parametrów opcjonalnych, zobacz Parametry opcjonalne w rozwiązaniach pakietu Office.

Dotyczy