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

第一個排序欄位，以文字 (範圍名稱) 或物件 (“Dept” 或 Range Cells (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 。若要排序中文字符，此範例假設使用者具有 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 方法

定義

參數

傳回

範例

備註

選擇性參數

適用於

其他資源