NamedRange.Sort – metoda
Seřadí data NamedRange řízení.
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
- Key1
Typ: System.Object
První řazení polejako text (název oblasti) nebo Microsoft.Office.Interop.Excel.Range objekt ("Oddělení" nebo Cells(1, 1), například).
- Order1
Typ: Microsoft.Office.Interop.Excel.XlSortOrder
Pořadí řazení pole nebo oblasti určené v Key1.
Může být jeden z následujících XlSortOrder hodnoty:
xlDescending .Seřadí Key1 v sestupném pořadí.
xlAscending .Seřadí Key1 ve vzestupném pořadí.
- Key2
Typ: System.Object
Druhý řazení polejako text (název oblasti) nebo Microsoft.Office.Interop.Excel.Range objekt.Pokud tento argumentvynecháte, není žádné druhé třídící pole.
- Type
Typ: System.Object
Určuje, které prvky jsou seřazeny.Použít tohoto argument pouze při řazení kontingenční tabulka .
Může být jeden z následujících XlSortType hodnoty:
xlSortLabels .Seřadí kontingenční tabulka sestava podle štítků.
xlSortValues .Seřadí kontingenční tabulka sestava podle hodnot.
- Order2
Typ: Microsoft.Office.Interop.Excel.XlSortOrder
Rozsahu zadaném v pořadí řazení Key2.Nelze použít při řazení kontingenční tabulka .
Může být jeden z následujících XlSortOrder hodnoty:
xlDescending .Seřadí Key2 v sestupném pořadí.
xlAscending .Seřadí Key2 ve vzestupném pořadí.
- Key3
Typ: System.Object
Třetí řazení polejako text (název oblasti) nebo Microsoft.Office.Interop.Excel.Range objekt.Pokud tento argumentvynecháte, není žádná třetí třídící pole.Nelze použít při řazení kontingenční tabulka .
- Order3
Typ: Microsoft.Office.Interop.Excel.XlSortOrder
Pořadí řazení pole nebo oblasti určené v Key3.Nelze použít při řazení kontingenční tabulka .
Může být jeden z následujících XlSortOrder hodnoty:
xlDescending .Seřadí Key3 v sestupném pořadí.
xlAscending .Seřadí Key3 ve vzestupném pořadí.
- Header
Typ: Microsoft.Office.Interop.Excel.XlYesNoGuess
Určuje, zda první řádek obsahuje záhlaví.Nelze použít při řazení kontingenční tabulka .
Může být jeden z následujících XlYesNoGuess hodnoty:
xlGuess .Umožňují určit, zda je hlavička systém Microsoft Office Excel a zjistit, kde je, pokud existuje.
xlNo .(Celý rozsah by třídění).
xlYes .(Celý rozsah by třídění).
- OrderCustom
Typ: System.Object
Tento argument je posun vycházející z jedničky integer v seznamu vlastní pořadí řazení.Vynecháte-li OrderCustom, je použito řazení normální.
- MatchCase
Typ: System.Object
true jak velká a malá písmena řazení; falseprovést řazení nejsou rozlišována.Nelze použít při řazení kontingenční tabulka .
- Orientation
Typ: Microsoft.Office.Interop.Excel.XlSortOrientation
Řazení orientace.
Může být jeden z následujících XlSortOrientation hodnoty:
xlSortRows .Seřadí položky podle řádku.
xlSortColumns .Seřadí položky podle sloupce.
- SortMethod
Typ: Microsoft.Office.Interop.Excel.XlSortMethod
Typ řazení.Některé z těchto konstant nemusí být dostupné, v závislosti na podporu jazyka (USANapříklad angličtina,), nainstalována nebo vybrané.
Může být jeden z následujících XlSortMethod hodnoty:
xlStroke .Třídění podle množství tahy v jednotlivých znaků.
xlPinYin .Fonetický čínských pořadí řazení znaků.
- DataOption1
Typ: Microsoft.Office.Interop.Excel.XlSortDataOption
Určuje způsob řazení textu v key1.Nelze použít při řazení kontingenční tabulka .
Může být jeden z následujících XlSortDataOption hodnoty:
xlSortTextAsNumbers .Text považovat číselné údaje pro řazení.
xlSortNormal .Seřadí data číselné a textové samostatně.
- DataOption2
Typ: Microsoft.Office.Interop.Excel.XlSortDataOption
Určuje způsob řazení textu v key2.Nelze použít při řazení kontingenční tabulka .
Může být jeden z následujících XlSortDataOption hodnoty:
xlSortTextAsNumbers .K řazení považuje text za číselná data.
xlSortNormal .Seřadí data číselné a textové samostatně.
- DataOption3
Typ: Microsoft.Office.Interop.Excel.XlSortDataOption
Určuje způsob řazení textu v key3.Nelze použít při řazení kontingenční tabulka .
Může být jeden z následujících XlSortDataOption hodnoty:
xlSortTextAsNumbers .K řazení považuje text za číselná data.
xlSortNormal .Seřadí data číselné a textové samostatně.
Vrácená hodnota
Typ: System.Object
Poznámky
Nastavení Header, Order1, Order2, Order3, OrderCustom, a Orientation jsou uloženy pro konkrétní listpokaždé, když použijete tuto metoda. Pokud nezadáte hodnoty pro tyto argumenty při příštím volání metoda, jsou použity uložené hodnoty. Tyto argumenty výslovně nastavte pokaždé, když použijete tuto metoda, pokud se rozhodnete použít uložené hodnoty.
Obvykle jsou řazeny textových řetězců, které nejsou konvertibilní číselná data.
Pokud tato metodanení definováno žádné argumenty, systém Microsoft Office Excel výběr ve vzestupném pořadí řazení.
Volitelné parametry
Informace o volitelných parametrů, viz The Variable missing and Optional Parameters in Office Solutions.
Příklady
Následující příklad kódu sada celých čísel do buňky A1 až A5 a použije Sort metoda řazení dat ve vzestupném pořadí.
Tento příklad je přizpůsobení ú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", missing].Value2 = 30;
this.Range["A2", missing].Value2 = 10;
this.Range["A3", missing].Value2 = 20;
this.Range["A4", missing].Value2 = 50;
this.Range["A5", missing].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
- Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.