通过

NamedRange.SortSpecial 方法

  • 项目

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

命名空间：  Microsoft.Office.Tools.Excel
程序集：  Microsoft.Office.Tools.Excel（在 Microsoft.Office.Tools.Excel.dll 中）

语法

声明
Function SortSpecial ( _
    SortMethod As XlSortMethod, _
    Key1 As Object, _
    Order1 As XlSortOrder, _
    Type As Object, _
    Key2 As Object, _
    Order2 As XlSortOrder, _
    Key3 As Object, _
    Order3 As XlSortOrder, _
    Header As XlYesNoGuess, _
    OrderCustom As Object, _
    MatchCase As Object, _
    Orientation As XlSortOrientation, _
    DataOption1 As XlSortDataOption, _
    DataOption2 As XlSortDataOption, _
    DataOption3 As XlSortDataOption _
) As Object

Object SortSpecial(
    XlSortMethod SortMethod,
    Object Key1,
    XlSortOrder Order1,
    Object Type,
    Object Key2,
    XlSortOrder Order2,
    Object Key3,
    XlSortOrder Order3,
    XlYesNoGuess Header,
    Object OrderCustom,
    Object MatchCase,
    XlSortOrientation Orientation,
    XlSortDataOption DataOption1,
    XlSortDataOption DataOption2,
    XlSortDataOption DataOption3
)

参数

  • SortMethod
    类型：Microsoft.Office.Interop.Excel.XlSortMethod
    排序的类型。其中一些常数可能对您不可用，这取决于您所选择或安装的支持语言 (例如 U.S. 英语)。
    可以是下列 XlSortMethod 值之一：
    xlStroke .按每个字符中的笔画数进行排序。
    xlPinYin （默认）。字符的中文拼音排序顺序。
  • Type
    类型：System.Object
    指定要进行排序的元素。只有当对数据透视表进行排序时，才使用此参数。
  • Key2
    类型：System.Object
    第二个排序字段，要么是文本（范围名称），要么是一个 Microsoft.Office.Interop.Excel.Range 对象。如果您省略此参数，则没有第二个排序字段。不可用于数据透视表的排序。
  • Key3
    类型：System.Object
    第三个排序字段，要么是文本（范围名称），要么是一个 Microsoft.Office.Interop.Excel.Range 对象。如果您省略此参数，则没有第三个排序字段。不可用于数据透视表的排序。
  • Header
    类型：Microsoft.Office.Interop.Excel.XlYesNoGuess
    指定第一行中是否包含标题。不可用于数据透视表的排序。
    可以是下列 XlYesNoGuess 值之一：
    xlGuess .让 Microsoft Office Excel 确定是否有标题，如果有的话，确定它的位置。
    xlNo （默认）。应当对整个范围进行排序。
    xlYes .不应当对整个范围进行排序。
  • OrderCustom
    类型：System.Object
    此参数是一个在自定义排序顺序列表中的从 1 开始的整数偏移量。如果忽略 OrderCustom，则使用正常排序顺序。
  • MatchCase
    类型：System.Object
    如果执行区分大小写的排序，则为 true；如果执行不区分大小写的排序，则为 false。不可用于数据透视表的排序。

返回值

类型：System.Object

备注

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

可选参数

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

示例

下面的代码示例使用 SortSpecial 方法，按拼音（字符的中文拼音排序顺序）对 NamedRange 进行排序。若要对中文字符进行排序，则此示例假定用户具有对 Microsoft Office Excel 的中文语言支持。如果用户没有中文语言支持，Excel 将默认为按值对 NamedRange 进行排序。

此示例针对的是文档级自定义项。

    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


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

}

.NET Framework 安全性

请参见

参考

NamedRange 接口

Microsoft.Office.Tools.Excel 命名空间