Sdílet prostřednictvím

NamedRange.Sort – metoda

  • Článek

Seřadí data NamedRange ovládacího prvku.

Obor názvů:  Microsoft.Office.Tools.Excel
Sestavení:  Microsoft.Office.Tools.Excel (v Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Deklarace
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
    Určuje prvky, které mají být seřazeny.Tento argument lze používáte pouze v případě, že řazení kontingenční tabulky.
    Může být jeden z následujících XlSortType hodnoty:
    xlSortLabels .Sestava kontingenční tabulky jsou řazeny podle štítků.
    xlSortValues .Sestava kontingenční tabulky jsou řazeny podle hodnoty.
  • Key3
    Typ: System.Object
    Třetí třídící pole jako text (název oblasti) nebo Microsoft.Office.Interop.Excel.Range objektu.Pokud tento argument vynecháte, není žádná třetí třídící pole.Nelze použít při řazení kontingenční tabulky.
  • Header
    Typ: Microsoft.Office.Interop.Excel.XlYesNoGuess
    Určuje, zda první řádek obsahuje záhlaví.Nelze použít při řazení kontingenční tabulky.
    Může být jeden z následujících XlYesNoGuess hodnoty:
    xlGuess .Umožní zjistit, zda je záhlaví aplikace Microsoft Office Excel a chcete-li zjistit, kde je, pokud existuje.
    xlNo . (Celý rozsah by třídění).
    xlYes . (Celý rozsah by neměl třídí).
  • OrderCustom
    Typ: System.Object
    Tento argument je posun jedničky integer do seznamu vlastní pořadí řazení.Vynecháte-li OrderCustom, se používá normální řazení.
  • MatchCase
    Typ: System.Object
    true Chcete-li se malá a velká písmena řazení; falseChcete provést řazení, která není velká a malá písmena.Nelze použít při řazení kontingenční tabulky.
  • SortMethod
    Typ: Microsoft.Office.Interop.Excel.XlSortMethod
    Typ řazení.Některé z těchto konstant nemusí být dostupné, v závislosti na jazyková podpora (USAngličtině, například), který jste vybrán nebo nainstalován.
    Může být jeden z následujících XlSortMethod hodnoty:
    xlStroke .Řazení podle počtu tahů v jednotlivých znaků.
    xlPinYin .Fonetický čínských pořadí řazení pro znaky.

Vrácená hodnota

Typ: System.Object

Poznámky

Nastavení pro Header, Order1, Order2, Order3, OrderCustom, a Orientation jsou uloženy pro konkrétní list pokaždé, když použijete tuto metodu.Pokud nezadáte hodnoty pro tyto argumenty při dalším volání metody, se používají uložené hodnoty.Tyto argumenty explicitně nastavte pokaždé, když použijete tuto metodu, pokud se rozhodnete použít uložené hodnoty.

Obvykle jsou řazeny textových řetězců, které nejsou konvertibilní číselná data.

Pokud při použití této metody jsou definovány žádné argumenty, aplikace Microsoft Office Excel výběr ve vzestupném pořadí řazení.

Volitelné parametry

Informace o nepovinných parametrů naleznete v tématu Volitelné parametry v řešeních pro systém Office.

Příklady

Následující příklad kódu vloží do buňky A1 až A5 množinu celých čísel a potom použije Sort metoda, chcete-li seřadit data vzestupně.

Tento příklad je pro vlastní úpravy úrovni 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);
}

Zabezpečení rozhraní .NET Framework

Viz také

Referenční dokumentace

NamedRange Rozhraní

Microsoft.Office.Tools.Excel – obor názvů