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 elementy, które mają być sortowane.Ten argument należy używać tylko wtedy, gdy sortowanie raportów tabeli przestawnej.
    Może być jedną z następujących XlSortType wartości:
    xlSortLabels .Raport tabeli przestawnej sortuje według etykiet.
    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 trzeciego pól 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ć jedną z następujących XlYesNoGuess wartości:
    xlGuess .Niech program Microsoft Office Excel, ustalić, czy jest nagłówek oraz w celu ustalenia, gdzie się znajduje, jeżeli jest ono.
    xlNo .(Cały zakres sortowania).
    xlYes .(Nie można posortować całego zakresu).
  • 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, normalnej sortowania jest używany.
  • MatchCase
    Typ: System.Object
    true Aby zrobić sortowania uwzględnia wielkość liter; 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 tego, obsługa języków (U.S. angielski, na przykład) który został wybrany lub zainstalowany.
    Może być jedną 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ą przechowywane, przez konkretny arkusz przy każdym użyciu 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.Zestaw tych argumentów jawnie przy każdym użyciu tej metody, jeśli nie chcesz używać zapisane wartości.

Ciągi tekstowe, które nie są zamienne na dane liczbowe są zwykle sortowane.

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

Parametry opcjonalne

Aby uzyskać informacje o opcjonalnych parametrów, zobacz Parametry opcjonalne w rozwiązania dla pakietu 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 metodę, aby posortować dane w kolejności rosnącej.

Ten przykład dotyczy dostosowywania poziomie 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