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

Sortuje dane w kontrolce NamedRange .

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

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

Key1: Object

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

Order1: XlSortOrder

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

Key2: Object

Drugie pole sortowania, jako tekst (nazwa zakresu) lub Range obiekt. W przypadku pominięcia tego argumentu nie ma drugiego pola sortowania.

Type: Object

Określa, które elementy mają być sortowane. Ten argument jest używany tylko w przypadku sortowania raportów w formie tabeli przestawnej. Może być jedną z następujących XlSortType wartości: xlSortLabels. Sortuje raport w formie tabeli przestawnej według etykiet. xlSortValues. Sortuje raport w formie tabeli przestawnej według wartości.

Order2: XlSortOrder

Kolejność sortowania zakresu określonego w elemecie 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. 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 elemecie 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. 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. Pozwól programowi Microsoft Office Excel określić, czy istnieje nagłówek, i określić, gdzie jest, jeśli istnieje. xlNo. (Cały zakres powinien być posortowany). xlYes. (Cały zakres nie powinien być sortowany).

OrderCustom: Object

Ten argument jest jednokierunkowym przesunięciem liczb całkowitych na listę niestandardowych zamówień sortowania. Jeśli pominięto OrderCustommetodę , używany jest normalny sortowanie.

MatchCase: Object

true w celu przeprowadzenia sortowania uwzględniającego wielkość liter; false w celu wykonania sortowania, które nie jest uwzględniane 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. Sortuje według wiersza. xlSortColumns. Sortuje według kolumny.

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 angielski 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. Fonetyczna chińska kolejność sortowania znaków.

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. Traktuj tekst jako dane liczbowe dla sortowania. xlSortNormal. 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. 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. Sortuje oddzielnie dane liczbowe i tekstowe.

Zwraca

Object

Przykłady

Poniższy przykład kodu umieszcza zestaw liczb całkowitych w komórkach A1 do A5, a następnie używa Sort metody do sortowania danych w kolejności rosnącej.

Ten przykład dotyczy dostosowywania na poziomie dokumentu.

private void SortNamedRange()
{
    // Set some data in a range of cells.
    this.Range["A1"].Value2 = 30;
    this.Range["A2"].Value2 = 10;
    this.Range["A3"].Value2 = 20;
    this.Range["A4"].Value2 = 50;
    this.Range["A5"].Value2 = 40;

    // Create a NamedRange that refers to the range.
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    // Sort the NamedRange.
    namedRange1.Sort(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.XlSortMethod.xlStroke,
        Excel.XlSortDataOption.xlSortNormal,
        Excel.XlSortDataOption.xlSortNormal,
        Excel.XlSortDataOption.xlSortNormal);
}

Private Sub SortNamedRange()
    ' Set some data in a range of cells.
    Me.Range("A1").Value2 = 30
    Me.Range("A2").Value2 = 10
    Me.Range("A3").Value2 = 20
    Me.Range("A4").Value2 = 50
    Me.Range("A5").Value2 = 40

    ' Create a NamedRange that refers to the range.
    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
        "namedRange1")

    ' Sort the NamedRange.
    namedRange1.Sort(Me.Range("A1", "A5"), _
        Excel.XlSortOrder.xlAscending, , , _
        Excel.XlSortOrder.xlAscending, , _
        Excel.XlSortOrder.xlAscending, Excel.XlYesNoGuess.xlNo, , , _
        Excel.XlSortOrientation.xlSortColumns, _
        Excel.XlSortMethod.xlStroke, _
        Excel.XlSortDataOption.xlSortNormal, _
        Excel.XlSortDataOption.xlSortNormal, _
        Excel.XlSortDataOption.xlSortNormal)
End Sub

Uwagi

Ustawienia dla Header, , Order1, Order2Order3, OrderCustomi Orientation są zapisywane dla określonego arkusza za każdym razem, gdy używasz tej metody. Jeśli nie określisz wartości dla tych argumentów, przy następnym wywołaniu metody zapisane wartości będą używane. Ustaw te argumenty jawnie za każdym razem, gdy używasz tej metody, jeśli nie chcesz używać zapisanych wartości.

Ciągi tekstowe, które nie są konwertowane na dane liczbowe, są sortowane normalnie.

Jeśli w tej metodzie nie zdefiniowano żadnych argumentów, program Microsoft Office Excel posortuje 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