Sdílet prostřednictvím

NamedRange.Sort – metoda

  • Článek

Seřadí data v 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žívejte pouze v případě, že řazení kontingenční tabulky.
    Může nabývat jedné 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, je žádné třetí pole pro řazení.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 nabývat jedné 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 mají být řazeny).
    xlYes .(Celý rozsah by neměl seřazeny).
  • OrderCustom
    Typ: System.Object
    Tento argument je posun jedničky celé číslo do seznamu vlastní pořadí řazení.Vynecháte-li OrderCustom, se používá normální řazení.
  • MatchCase
    Typ: System.Object
    true Chcete-li malá a velká písmena řazení; falseChcete-li seřadit, 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 následujících konstant nemusí být k dispozici, v závislosti na jazykové podpory (U.S. , například angličtina), nainstalována nebo vybrané.
    Může nabývat jedné z následujících XlSortMethod hodnoty:
    xlStroke .Řazení podle počtu tahů v jednotlivých znaků.
    xlPinYin .Fonetické čínské řazení znaků.

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 příští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.

Textové řetězce, které nejsou převoditelné číselná data jsou řazena normálně.

Pokud při použití této metody jsou definovány žádné argumenty, bude aplikace Microsoft Office Excel Seřadí vybranou ve vzestupném pořadí.

Volitelné parametry

Informace o volitelných parametrů naleznete v tématu Volitelné parametry v Office Solutions.

Příklady

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

V tomto příkladu je úroveň dokument přizpůsobení.

    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ů