NamedRange.Sort 方法

参考

定义

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

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

重要

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

对 NamedRange 控件中的数据进行排序。

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

abstract member Sort : 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.XlSortMethod * Microsoft.Office.Interop.Excel.XlSortDataOption * Microsoft.Office.Interop.Excel.XlSortDataOption * Microsoft.Office.Interop.Excel.XlSortDataOption -> obj

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”或 Cells (1， 1) ，例如) 。

Order1: XlSortOrder

中指定的字段或范围的 Key1排序顺序。可以是以下 XlSortOrder 值之一： xlDescending。 Key1按降序排序。 xlAscending. Key1按升序排序。

Key2: Object

第二个排序字段，要么是文本（范围名称），要么是一个 Range 对象。如果您省略此参数，则没有第二个排序字段。

Type: Object

指定要进行排序的元素。仅当对数据透视表进行排序时，才使用此参数。可以是以下 XlSortType 值之一： xlSortLabels。按标签对数据透视表进行排序。 xlSortValues. 按值对数据透视表进行排序。

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. 按列排序。

SortMethod: XlSortMethod

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

DataOption1: XlSortDataOption

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

DataOption2: XlSortDataOption

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

DataOption3: XlSortDataOption

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

Object

示例

下面的代码示例在单元格 A1 到 A5 中放置一组整数，然后使用 Sort 方法按升序对数据进行排序。

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

private void SortNamedRange()
{
    // Set some data in a range of cells.
    this.Range["A1"].Value2 = 30;
    this.Range["A2"].Value2 = 10;
    this.Range["A3"].Value2 = 20;
    this.Range["A4"].Value2 = 50;
    this.Range["A5"].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);
}

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

注解

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

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

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

可选参数

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

适用于

通过

NamedRange.Sort 方法

定义

参数

返回

示例

注解

可选参数

适用于

其他资源