NamedRange.Sort Metoda

Reference

Definice

Obor názvů:: Microsoft.Office.Tools.Excel

Sestavení:: Microsoft.Office.Tools.Excel.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Seřadí data v ovládacím NamedRange prvku.

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

První pole řazení, například jako text (název oblasti) nebo Range objekt (oddělení nebo buňky(1, 1).

Order1: XlSortOrder

Pořadí řazení pro pole nebo oblast zadanou v Key1. Může mít jednu z následujících XlSortOrder hodnot: xlDescending. Seřadí Key1 v sestupném pořadí. xlAscending. Seřadí Key1 se vzestupně.

Key2: Object

Druhé pole řazení, buď jako text (název oblasti), nebo Range jako objekt. Pokud tento argument vynecháte, neexistuje žádné druhé pole řazení.

Type: Object

Určuje, které prvky mají být seřazeny. Tento argument použijte pouze při řazení sestav kontingenční tabulky. Může mít jednu z následujících XlSortType hodnot: xlSortLabels. Seřadí sestavu kontingenční tabulky podle popisků. xlSortValues. Seřadí sestavu kontingenční tabulky podle hodnot.

Order2: XlSortOrder

Pořadí řazení pro oblast zadanou v Key2. Nelze použít při řazení sestav kontingenčních tabulek. Může mít jednu z následujících XlSortOrder hodnot: xlDescending. Seřadí Key2 v sestupném pořadí. xlAscending. Seřadí Key2 se vzestupně.

Key3: Object

Třetí pole řazení, buď jako text (název oblasti), nebo Range jako objekt. Pokud tento argument vynecháte, neexistuje žádné třetí pole řazení. Nelze použít při řazení sestav kontingenční tabulky.

Order3: XlSortOrder

Pořadí řazení pro pole nebo oblast zadanou v Key3. Nelze použít při řazení sestav kontingenčních tabulek. Může mít jednu z následujících XlSortOrder hodnot: xlDescending. Seřadí Key3 v sestupném pořadí. xlAscending. Seřadí Key3 se vzestupně.

Header: XlYesNoGuess

Určuje, jestli první řádek obsahuje záhlaví. Nelze použít při řazení sestav kontingenčních tabulek. Může mít jednu z následujících XlYesNoGuess hodnot: xlGuess. Nechte Aplikaci Microsoft Office Excel určit, zda existuje záhlaví, a určit, kde se nachází, pokud existuje. xlNo. (Měla by být seřazena celá oblast.) xlYes. (Celý rozsah by neměl být seřazený.)

OrderCustom: Object

Tento argument je celočíselný posun seznamu vlastních pořadí řazení o jedno číslo. Pokud vynecháte OrderCustom, použije se normální řazení.

MatchCase: Object

true řazení s rozlišováním velkých a malých písmen; false a proveďte řazení, které nerozlišuje malá a velká písmena. Nelze použít při řazení sestav kontingenční tabulky.

Orientation: XlSortOrientation

Orientace řazení Může mít jednu z následujících XlSortOrientation hodnot: xlSortRows. Seřadí podle řádku. xlSortColumns. Seřadí podle sloupce.

SortMethod: XlSortMethod

Typ řazení. Některé z těchto konstant pro vás nemusí být dostupné v závislosti na jazykové podpoře (například americké angličtině), kterou jste vybrali nebo nainstalovali. Může mít jednu z následujících XlSortMethod hodnot: xlStroke. Řazení podle počtu tahů v jednotlivých znacích xlPinYin. Fonetické pořadí řazení znaků v čínštině.

DataOption1: XlSortDataOption

Určuje způsob řazení textu v nástroji key1. Nelze použít při řazení sestav kontingenčních tabulek. Může mít jednu z následujících XlSortDataOption hodnot: xlSortTextAsNumbers. Nakládat s textem jako s číselnými daty pro řazení. xlSortNormal. Řadí číselné a textové údaje zvlášť.

DataOption2: XlSortDataOption

Určuje způsob řazení textu v nástroji key2. Nelze použít při řazení sestav kontingenčních tabulek. Může mít jednu z následujících XlSortDataOption hodnot: xlSortTextAsNumbers. Považuje text za číselné údaje pro řazení. xlSortNormal. Řadí číselné a textové údaje zvlášť.

DataOption3: XlSortDataOption

Určuje způsob řazení textu v nástroji key3. Nelze použít při řazení sestav kontingenčních tabulek. Může mít jednu z následujících XlSortDataOption hodnot: xlSortTextAsNumbers. Považuje text za číselné údaje pro řazení. xlSortNormal. Řadí číselné a textové údaje zvlášť.

Návraty

Object

Příklady

Následující příklad kódu umístí sadu celých čísel do buněk A1 až A5 a pak použije metodu Sort k seřazení dat ve vzestupném pořadí.

Tento příklad je pro přizpůsobení na úrovni 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

Poznámky

Nastavení pro Header, , Order1, Order2Order3, OrderCustoma Orientation se uloží pro konkrétní list pokaždé, když použijete tuto metodu. Pokud nezadáte hodnoty pro tyto argumenty při příštím volání metody, použijí se uložené hodnoty. Tyto argumenty explicitně nastavte při každém použití této metody, pokud se rozhodnete nepoužívat uložené hodnoty.

Textové řetězce, které nejsou převoditelné na číselná data, jsou seřazeny běžným způsobem.

Pokud nejsou pomocí této metody definovány žádné argumenty, seřadí aplikace Microsoft Office Excel výběr ve vzestupném pořadí.

Volitelné parametry

Informace o volitelných parametrech najdete v tématu Volitelné parametry v řešeních pro systém Office.

Platí pro