Excel) (SortFields.Add 方法

创建新的排序字段,并返回一个 SortFields 对象。

语法

表达式。添加 (键、 SortOn、 Order、 CustomOrder、 DataOption)

表达式 表示 SortFields 对象的变量。

参数

名称 必需/可选 数据类型 说明
键 必需 区域 指定用于排序的键值。
SortOn 可选 Variant 一个 XlSortOn 值,该值指定要用于排序的单元格属性。
Order 可选 Variant 指定排序顺序的 XlSortOrder 值。
CustomOrder 可选 Variant 指定是否应使用自定义排序次序。
DataOption 可选 Variant 指定如何对文本排序的 XlSortDataOption 值。

返回值

SortField

备注

此 API 不包括对数据类型的支持,如地理位置或股票。 若要基于其中一种类型的子字段定义排序顺序,请参阅 Add2 方法。

示例

此示例按列 1 升序对表 Table1 on Sheet1 进行排序。

之前调用 Clear 方法,以确保清除以前的排序,以便可以应用新的排序。

调用 Sort 对象以将添加的排序应用于 Table1。

ActiveWorkbook.Worksheets("Sheet1").ListObjects("Table1").Sort.SortFields.Clear
ActiveWorkbook.Worksheets("Sheet1").ListObjects("Table1").Sort.SortFields.Add _
 Key:=Range("Table1[[#All],[Column1]]"), _
 SortOn:=xlSortOnValues, _
 Order:=xlAscending, _
 DataOption:=xlSortNormal
With ActiveWorkbook.Worksheets("Sheet1").ListObjects("Table1").Sort
 .Header = xlYes
 .MatchCase = False
 .Orientation = xlTopToBottom
 .SortMethod = xlPinYin
 .Apply
End With

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈? 请参阅 Office VBA 支持和反馈,获取有关如何接收支持和提供反馈的指南。