NamedRange.SortSpecial 方法

参考

定义

命名空间:: Microsoft.Office.Tools.Excel

程序集:: Microsoft.Office.Tools.Excel.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

使用东亚排序方法对 NamedRange 控件进行排序。例如，在日语中，按照假名音节表顺序进行排序。有关更多信息，请参见参数列表。

public object SortSpecial(Microsoft.Office.Interop.Excel.XlSortMethod SortMethod = Microsoft.Office.Interop.Excel.XlSortMethod.xlPinYin, object Key1, Microsoft.Office.Interop.Excel.XlSortOrder Order1 = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, object Type, object Key2, 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.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);

abstract member SortSpecial : Microsoft.Office.Interop.Excel.XlSortMethod * obj * Microsoft.Office.Interop.Excel.XlSortOrder * obj * obj * Microsoft.Office.Interop.Excel.XlSortOrder * obj * Microsoft.Office.Interop.Excel.XlSortOrder * Microsoft.Office.Interop.Excel.XlYesNoGuess * obj * obj * Microsoft.Office.Interop.Excel.XlSortOrientation * Microsoft.Office.Interop.Excel.XlSortDataOption * Microsoft.Office.Interop.Excel.XlSortDataOption * Microsoft.Office.Interop.Excel.XlSortDataOption -> obj

Public Function SortSpecial (Optional SortMethod As XlSortMethod = Microsoft.Office.Interop.Excel.XlSortMethod.xlPinYin, Optional Key1 As Object, Optional Order1 As XlSortOrder = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, Optional Type As Object, Optional Key2 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 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

参数

SortMethod: XlSortMethod

排序的类型。其中一些常量可能不可用，具体取决于美国英语 (语言支持，例如你选择或安装的) 。可以是以下 XlSortMethod 值之一： xlStroke。按每个字符中的笔画数进行排序。 xlPinYin（默认）。字符的中文拼音排序顺序。

Key1: Object

第一个排序字段，如文本 (区域名称) 或 Range 对象 (“Dept”或单元格 (1、1) ，例如) 。

Order1: XlSortOrder

中指定的 Key1字段或区域的排序顺序。可以是以下 XlSortOrder 值之一： xlDescending。 Key1按降序排序。 xlAscending（默认值）。 Key1按升序排序。

Type: Object

指定要进行排序的元素。只有当对数据透视表进行排序时，才使用此参数。

Key2: Object

第二个排序字段，要么是文本（范围名称），要么是一个 Range 对象。如果您省略此参数，则没有第二个排序字段。不可用于数据透视表的排序。

Order2: XlSortOrder

参数中指定的 Key2 字段或范围的排序顺序。对数据透视表进行排序时无法使用。可以是以下 XlSortOrder 值之一： xlDescending。 Key2按降序排序。 xlAscending（默认值）。 Key2按升序排序。

Key3: Object

第三个排序字段，要么是文本（范围名称），要么是一个 Range 对象。如果您省略此参数，则没有第三个排序字段。不可用于数据透视表的排序。

Order3: XlSortOrder

参数中指定的 Key3 字段或范围的排序顺序。对数据透视表进行排序时无法使用。可以是以下 XlSortOrder 值之一： xlDescending。 Key3按降序排序。 xlAscending（默认值）。 Key3按升序排序。

Header: XlYesNoGuess

指定第一行中是否包含标题。对数据透视表进行排序时无法使用。可以是以下 XlYesNoGuess 值之一： xlGuess。让 Microsoft Office Excel 确定是否有标题，如果有的话，确定它的位置。 xlNo（默认）。应当对整个范围进行排序。 xlYes. 不应当对整个范围进行排序。

OrderCustom: Object

此参数是一个在自定义排序顺序列表中的从 1 开始的整数偏移量。如果省略 OrderCustom，则使用常规排序顺序。

MatchCase: Object

如果执行区分大小写的排序，则为 true；如果执行不区分大小写的排序，则为 false。不可用于数据透视表的排序。

Orientation: XlSortOrientation

排序方向。可以是以下 XlSortOrientation 值之一： xlSortRows (默认) 。按行进行排序。 xlSortColumns. 按列进行了排序。

DataOption1: XlSortDataOption

指定如何在中 key1对文本进行排序。对数据透视表进行排序时无法使用。可以是以下 XlSortDataOption 值之一： xlSortTextAsNumbers。在进行排序时将文本数据视为数值数据。 xlSortNormal（默认）。分别对数值数据和文本数据进行排序。

DataOption2: XlSortDataOption

指定如何在中 key2对文本进行排序。对数据透视表进行排序时无法使用。可以是以下 XlSortDataOption 值之一： xlSortTextAsNumbers。在进行排序时将文本数据视为数值数据。 xlSortNormal（默认）。分别对数值数据和文本数据进行排序。

DataOption3: XlSortDataOption

指定如何在中 key3对文本进行排序。对数据透视表进行排序时无法使用。可以是以下 XlSortDataOption 值之一： xlSortTextAsNumbers。在进行排序时将文本数据视为数值数据。 xlSortNormal（默认）。分别对数值数据和文本数据进行排序。

Object

示例

下面的代码示例使用 SortSpecial 方法对 NamedRange 使用 Pin Yin (字符) 的拼音中文排序顺序进行排序。若要对中文字符进行排序，本示例假定用户具有对 Microsoft Office Excel 的中文支持。如果用户不支持中文，Excel 将默认按值排序 NamedRange 。

此示例适用于文档级自定义项。

private void SortSpecialNamedRange()
{
    this.Range["A1"].Value2 = 50;
    this.Range["A2"].Value2 = 10;
    this.Range["A3"].Value2 = 20;
    this.Range["A4"].Value2 = 30;
    this.Range["A5"].Value2 = 40;

    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    namedRange1.SortSpecial(Excel.XlSortMethod.xlPinYin,
        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.XlSortDataOption.xlSortNormal,
        Excel.XlSortDataOption.xlSortNormal,
        Excel.XlSortDataOption.xlSortNormal);

}

Private Sub SortSpecialNamedRange()
    Me.Range("A1").Value2 = 50
    Me.Range("A2").Value2 = 10
    Me.Range("A3").Value2 = 20
    Me.Range("A4").Value2 = 30
    Me.Range("A5").Value2 = 40

    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
        "namedRange1")

    namedRange1.SortSpecial(Excel.XlSortMethod.xlPinYin, _
        Me.Range("A1", "A5"), Excel.XlSortOrder.xlAscending, , , _
        Excel.XlSortOrder.xlAscending, , _
        Excel.XlSortOrder.xlAscending, _
        Excel.XlYesNoGuess.xlNo, , , _
        Excel.XlSortOrientation.xlSortColumns, _
        Excel.XlSortDataOption.xlSortNormal, _
        Excel.XlSortDataOption.xlSortNormal, _
        Excel.XlSortDataOption.xlSortNormal)
End Sub

注解

如果未使用此方法定义参数，Microsoft Office Excel 将按升序对所选内容进行排序。

可选参数

有关可选参数的信息，请参阅 Office 解决方案中的可选参数。

适用于

通过

NamedRange.SortSpecial 方法

定义

参数

返回

示例

注解

可选参数

适用于

其他资源