Range.Sort 方法

定义

命名空间:

Microsoft.Office.Interop.Excel

程序集:

Microsoft.Office.Interop.Excel.dll

如果指定的区域仅包含一个单元格，则对数据透视表、区域或活动区域进行排序。

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);

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

参数

Key1

Object

可选 对象。 第一个排序字段，作为文本 (数据透视表字段或区域名称) 或 Range 对象 (“Dept”或单元格 (1,1) ，例如) 。

Order1

XlSortOrder

可选 XlSortOrder。 中指定的字段或区域的 Key1排序顺序。 可以是以下 XlSortOrder 常量之一：xlDescending。 Key1按降序排序。xlAscendingdefault。 按 Key1 升序排序。

Key2

Object

可选 对象。 第二个排序字段，可以是文本（数据透视表字段或区域名）也可以是 Range 对象。 如果省略该参数，则没有第二个排序字段。 对数据透视表报表进行排序时无法使用。

Type

Object

可选 对象。 指定要排序的元素。 仅在对数据透视表排序时才使用该参数。 可以是以下 XlSortType 常量之一：xlSortLabels。 按标签对数据透视表进行排序。xlSortValues。 按值对数据透视表排序。

Order2

XlSortOrder

可选 XlSortOrder。 中指定的字段或区域的 Key2排序顺序。 对数据透视表进行排序时，不能使用该参数。 可以是以下 XlSortOrder 常量之一：xlDescending。 Key2按降序排序。xlAscendingdefault。 按 Key2 升序排序。

Key3

Object

可选 对象。 第三个排序字段，可以是文本（区域名）也可以是 Range 对象。 如果省略该参数，则没有第三个排序字段。 对数据透视表进行排序时，不能使用该参数。

Order3

XlSortOrder

可选 XlSortOrder。 中指定的字段或区域的 Key3排序顺序。 对数据透视表进行排序时，不能使用该参数。 可以是以下 XlSortOrder 常量之一：xlDescending。 Key3按降序排序。xlAscendingdefault。 按 Key3 升序排序。

Header

XlYesNoGuess

可选 XlYesNoGuess。 指定第一行是否包含标题。 对数据透视表进行排序时，不能使用该参数。 可以是以下 XlYesNoGuess 常量之一：xlGuess。 让 Microsoft Excel 确定是否有标头，并确定是否有标头的位置。xlNodefault。 (应) 对整个范围进行排序。xlYes。 (不应) 对整个范围进行排序。

OrderCustom

Object

可选 对象。 该参数是从 1 开始的整数，指定了在自定义排序次序列表中的偏移量。 如果省略 OrderCustom，则使用普通排序。

MatchCase

Object

可选 对象。 如果为 True，则进行区分大小写的排序；如果为 False，则排序时不区分大小写。 对数据透视表进行排序时，不能使用该参数。

Orientation

XlSortOrientation

可选 XlSortOrientation。 排序方向。 可以是以下 XlSortOrientation 常量之一：xlSortRowsdefault。 按行排序。xlSortColumns。 按列排序。

SortMethod

XlSortMethod

可选 XlSortMethod。 排序类型。 这些常量中的某些可能不可用，这取决于选择或安装的语言支持（例如，美国英语）。 可以是以下 XlSortMethod 常量之一：xlStroke 按每个字符中的笔划数量排序。xlPinYindefault。 按字符的汉语拼音顺序排序。

DataOption1

XlSortDataOption

可选 XlSortDataOption。 指定如何在 中 Key 1对文本进行排序。 对数据透视表进行排序时，不能使用该参数。 可以是以下 XlSortDataOption 常量之一：xlSortTextAsNumbers。 将文本视为排序的数字数据。xlSortNormaldefault。 分别对数字和文本数据进行排序。

DataOption2

XlSortDataOption

可选 XlSortDataOption。 指定如何在 中 Key 2对文本进行排序。 对数据透视表进行排序时，不能使用该参数。 可以是以下 XlSortDataOption 常量之一：xlSortTextAsNumbers。 将文本视为排序的数字数据。xlSortNormaldefault。 分别对数字和文本数据进行排序。

DataOption3

XlSortDataOption

可选 XlSortDataOption。 指定如何对键 3 中的文本进行排序。 对数据透视表进行排序时，不能使用该参数。 可以是以下 XlSortDataOption 常量之一：xlSortTextAsNumbers。 将文本视为排序的数字数据。xlSortNormaldefault。 分别对数字和文本数据进行排序。

返回

Object

注解

每次使用此方法时，都会为特定工作表保存 、、 和 Orientation 的设置Order2OrderCustomHeaderOrder1Order3。 如果在下次调用 方法时未为这些参数指定值，则使用保存的值。 如果选择不使用保存的值，则每次使用 Sort 方法时显式设置这些参数。

无法转换为数值数据的文本字符串按正常排序。

如果使用 Sort 方法时没有定义参数，则 Microsoft Excel 会对所选定的要排序的区域按升序排序。