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
)

參數

  • Type
    型別：System.Object
    指定要排序哪一個項目。只有在排序樞紐分析表時才使用這個引數。
  • 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 命名空間