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

第一個排序欄位，以文字 (範圍名稱) 或物件 (“Dept” 或 Range 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

備註

Header每次使用此方法時，都會儲存特定工作表的、Order1Order3Order2、、、 OrderCustom和 Orientation 的設定。如果您下次呼叫方法時未指定這些自變數的值，則會使用儲存的值。如果您選擇不使用儲存的值，請在每次使用此方法時明確設定這些自變數。

無法轉換成數值數據的文字字串會正常排序。

如果未使用此方法定義任何自變數，Microsoft Office Excel 會以遞增順序排序選取範圍。

選擇性參數

如需選擇性參數的資訊，請參閱 Office 方案中的選擇性參數。

適用於

NamedRange.Sort 方法

定義

參數

傳回

範例

備註

選擇性參數

適用於

其他資源