NamedRange.SortSpecial Metode

Referensi

Definisi

Ruang nama:: Microsoft.Office.Tools.Excel

Rakitan:: Microsoft.Office.Tools.Excel.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menggunakan metode pengurutan Asia Timur untuk mengurutkan NamedRange kontrol. Misalnya, Bahasa Jepang mengurutkan dalam urutan suku kata Kana. Untuk informasi selengkapnya, lihat daftar parameter.

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

Parameter

SortMethod: XlSortMethod

Jenis semacam itu. Beberapa konstanta ini mungkin tidak tersedia untuk Anda, tergantung pada dukungan bahasa (Inggris AS, misalnya) yang telah Anda pilih atau instal. Bisa menjadi salah satu nilai berikut XlSortMethod : xlStroke. Mengurutkan menurut kuantitas goresan di setiap karakter. xlPinYin (default). Urutan sortir Tionghoa fonetik untuk karakter.

Key1: Object

Bidang pengurutan pertama, sebagai teks (nama rentang) atau Range objek ("Dept" atau Sel(1, 1), misalnya).

Order1: XlSortOrder

Urutan pengurutan untuk bidang atau rentang yang ditentukan dalam Key1. Bisa menjadi salah satu nilai berikut XlSortOrder : xlDescending. Mengurutkan Key1 dalam urutan turun. xlAscending (default). Mengurutkan Key1 dalam urutan naik.

Type: Object

Menentukan elemen mana yang akan diurutkan. Gunakan argumen ini hanya ketika mengurutkan laporan PivotTable.

Key2: Object

Bidang pengurutan kedua, sebagai teks (nama rentang) atau Range objek. Jika Anda menghilangkan argumen ini, tidak ada bidang pengurutan kedua. Tidak dapat digunakan saat mengurutkan laporan PivotTable.

Order2: XlSortOrder

Urutan pengurutan untuk bidang atau rentang yang ditentukan dalam Key2 argumen. Tidak dapat digunakan saat mengurutkan laporan PivotTable. Bisa menjadi salah satu nilai berikut XlSortOrder : xlDescending. Mengurutkan Key2 dalam urutan turun. xlAscending (default). Mengurutkan Key2 dalam urutan naik.

Key3: Object

Bidang pengurutan ketiga, sebagai teks (nama rentang) atau Range objek. Jika Anda menghilangkan argumen ini, tidak ada bidang pengurutan ketiga. Tidak dapat digunakan saat mengurutkan laporan PivotTable.

Order3: XlSortOrder

Urutan pengurutan untuk bidang atau rentang yang ditentukan dalam Key3 argumen. Tidak dapat digunakan saat mengurutkan laporan PivotTable. Bisa menjadi salah satu nilai berikut XlSortOrder : xlDescending. Mengurutkan Key3 dalam urutan turun. xlAscending (default). Mengurutkan Key3 dalam urutan naik.

Header: XlYesNoGuess

Menentukan apakah baris pertama berisi header atau tidak. Tidak dapat digunakan saat mengurutkan laporan PivotTable. Bisa menjadi salah satu nilai berikut XlYesNoGuess : xlGuess. Memungkinkan Microsoft Office Excel menentukan apakah ada header, dan untuk menentukan di mana header itu berada, jika ada. xlNo (default). Seluruh rentang harus diurutkan. xlYes. Seluruh rentang tidak boleh diurutkan.

OrderCustom: Object

Argumen ini adalah offset bilangan bulat berbasis satu ke daftar susunan urutan kustom. Jika Anda menghilangkan OrderCustom, urutan sortir normal digunakan.

MatchCase: Object

true untuk melakukan pengurutan peka huruf besar/kecil; false untuk melakukan pengurutan yang tidak peka huruf besar/kecil. Tidak dapat digunakan saat mengurutkan laporan PivotTable.

Orientation: XlSortOrientation

Orientasi pengurutan. Bisa menjadi salah satu nilai berikut XlSortOrientation : xlSortRows (default). Pengurutan dilakukan menurut baris. xlSortColumns. Pengurutan dilakukan menurut kolom.

DataOption1: XlSortDataOption

Menentukan cara mengurutkan teks dalam key1. Tidak dapat digunakan saat mengurutkan laporan PivotTable. Bisa menjadi salah satu nilai berikut XlSortDataOption : xlSortTextAsNumbers. Memperlakukan teks sebagai data numerik untuk pengurutan. xlSortNormal (default). Mengurutkan data numerik dan teks secara terpisah.

DataOption2: XlSortDataOption

Menentukan cara mengurutkan teks dalam key2. Tidak dapat digunakan saat mengurutkan laporan PivotTable. Bisa menjadi salah satu nilai berikut XlSortDataOption : xlSortTextAsNumbers. Memperlakukan teks sebagai data numerik untuk pengurutan. xlSortNormal (default). Mengurutkan data numerik dan teks secara terpisah.

DataOption3: XlSortDataOption

Menentukan cara mengurutkan teks dalam key3. Tidak dapat digunakan saat mengurutkan laporan PivotTable. Bisa menjadi salah satu nilai berikut XlSortDataOption : xlSortTextAsNumbers. Memperlakukan teks sebagai data numerik untuk pengurutan. xlSortNormal (default). Mengurutkan data numerik dan teks secara terpisah.

Mengembalikan

Object

Contoh

Contoh kode berikut menggunakan SortSpecial metode untuk mengurutkan NamedRange menggunakan Pin Yin (urutan sortir Tionghoa fonetik untuk karakter). Untuk mengurutkan karakter Tionghoa, contoh ini mengasumsikan pengguna memiliki dukungan bahasa Tionghoa untuk Microsoft Office Excel. Excel akan secara default mengurutkan NamedRange berdasarkan nilai jika pengguna tidak memiliki dukungan bahasa Tionghoa.

Contoh ini untuk kustomisasi tingkat dokumen.

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

Keterangan

Jika tidak ada argumen yang ditentukan dengan metode ini, Microsoft Office Excel mengurutkan pilihan dalam urutan naik.

Parameter Opsional

Untuk informasi tentang parameter opsional, lihat Parameter Opsional di Solusi Office.

Berlaku untuk

Bagikan melalui