Udostępnij za pośrednictwem

Metoda NamedRange.Sort —

  • Artykuł

Sortuje dane w NamedRange kontroli.

Przestrzeń nazw:  Microsoft.Office.Tools.Excel
Zestaw:  Microsoft.Office.Tools.Excel (w Microsoft.Office.Tools.Excel.dll)

Składnia

'Deklaracja
Function Sort ( _
    Key1 As Object, _
    Order1 As XlSortOrder, _
    Key2 As Object, _
    Type As Object, _
    Order2 As XlSortOrder, _
    Key3 As Object, _
    Order3 As XlSortOrder, _
    Header As XlYesNoGuess, _
    OrderCustom As Object, _
    MatchCase As Object, _
    Orientation As XlSortOrientation, _
    SortMethod As XlSortMethod, _
    DataOption1 As XlSortDataOption, _
    DataOption2 As XlSortDataOption, _
    DataOption3 As XlSortDataOption _
) As Object

Object Sort(
    Object Key1,
    XlSortOrder Order1,
    Object Key2,
    Object Type,
    XlSortOrder Order2,
    Object Key3,
    XlSortOrder Order3,
    XlYesNoGuess Header,
    Object OrderCustom,
    Object MatchCase,
    XlSortOrientation Orientation,
    XlSortMethod SortMethod,
    XlSortDataOption DataOption1,
    XlSortDataOption DataOption2,
    XlSortDataOption DataOption3
)

Parametry

  • Type
    Typ: System.Object
    Określa, które elementy mają być sortowane.Ten argument należy używać tylko wtedy, gdy sortowanie raportów tabeli przestawnej.
    Może być jednym z następujących XlSortType wartości:
    xlSortLabels .Podczas sortowania raportu tabeli przestawnej etykiety.
    xlSortValues .Raport tabeli przestawnej sortuje według wartości.
  • Key3
    Typ: System.Object
    Trzecie pole sortowania, jako text (nazwy zakresu) lub Microsoft.Office.Interop.Excel.Range obiektu.Jeśli ten argument zostanie pominięty, nie ma żadnych trzecie pole sortowania.Nie można używać podczas sortowania raportów tabeli przestawnej.
  • Header
    Typ: Microsoft.Office.Interop.Excel.XlYesNoGuess
    Określa, czy pierwszy wiersz zawiera nagłówki.Nie można używać podczas sortowania raportów tabeli przestawnej.
    Może być jednym z następujących XlYesNoGuess wartości:
    xlGuess .Niech program Microsoft Office Excel, ustalić, czy jest nagłówek oraz w celu ustalenia, gdzie jest, jeśli istnieje.
    xlNo . (Powinny być sortowane całego zakresu).
    xlYes . (Cały zakres nie można posortować).
  • OrderCustom
    Typ: System.Object
    Ten argument jest z przesunięciem liczby całkowitej na podstawie jednego do listy niestandardowej kolejności sortowania.Jeżeli pominięto OrderCustom, jest używany normalny sortowania.
  • MatchCase
    Typ: System.Object
    true Aby zrobić wielkość liter sortowania; falseAby to zrobić, sortowania, który nie jest uwzględniana wielkość liter.Nie można używać podczas sortowania raportów tabeli przestawnej.
  • SortMethod
    Typ: Microsoft.Office.Interop.Excel.XlSortMethod
    Typ sortowania.Niektóre z tych stałych mogą być niedostępne, w zależności od języka pomocy technicznej (USAAngielski, na przykład) które wybrałeś lub zainstalowany.
    Może być jednym z następujących XlSortMethod wartości:
    xlStroke .Sortowanie według ilości uderzeń w każdej postaci.
    xlPinYin .Chiński fonetyczny porządek sortowania dla znaków.

Wartość zwracana

Typ: System.Object

Uwagi

Ustawienia dla Header, Order1, Order2, Order3, OrderCustom, i Orientation są zapisywane dla określonego arkusza, korzystając z tej metody.Jeśli nie określisz wartości dla tych argumentów przy następnym wywołaniu metody, zapisane wartości są używane.Ustawić następujące argumenty jawnie korzystając z tej metody, jeśli nie chcesz używać wartości zapisane.

Ciągów tekstowych, które nie są konwertowane na dane liczbowe są zwykle sortowane.

Jeśli żadne argumenty są zdefiniowane przy użyciu tej metody, program Microsoft Office Excel posortuje zaznaczenia w kolejności rosnącej.

Parametry opcjonalne

Informacje na temat parametrów opcjonalnych, zobacz Parametry opcjonalne w rozwiązaniach Office.

Przykłady

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

W tym przykładzie jest dla dostosowania poziomu dokumentu.

    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


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);
}

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

NamedRange Interfejs

Przestrzeń nazw Microsoft.Office.Tools.Excel