NamedRange.Sort 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.

Mengurutkan data dalam NamedRange kontrol.

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

Parameter

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. Mengurutkan Key1 dalam urutan naik.

Key2: Object

Bidang pengurutan kedua, sebagai teks (nama rentang) atau Range objek. Jika Anda menghilangkan argumen ini, tidak ada bidang pengurutan kedua.

Type: Object

Menentukan elemen mana yang akan diurutkan. Gunakan argumen ini hanya ketika mengurutkan laporan PivotTable. Bisa menjadi salah satu nilai berikut XlSortType : xlSortLabels. Mengurutkan laporan PivotTable menurut label. xlSortValues. Mengurutkan laporan PivotTable menurut nilai.

Order2: XlSortOrder

Urutan pengurutan untuk rentang yang ditentukan dalam Key2. Tidak dapat digunakan saat mengurutkan laporan PivotTable. Bisa menjadi salah satu nilai berikut XlSortOrder : xlDescending. Mengurutkan Key2 dalam urutan turun. xlAscending. 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. Tidak dapat digunakan saat mengurutkan laporan PivotTable. Bisa menjadi salah satu nilai berikut XlSortOrder : xlDescending. Mengurutkan Key3 dalam urutan turun. xlAscending. 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. Biarkan Microsoft Office Excel menentukan apakah ada header, dan untuk menentukan di mana header tersebut berada, jika ada. xlNo. (Seluruh rentang harus diurutkan). xlYes. (Seluruh rentang tidak boleh diurutkan).

OrderCustom: Object

Argumen ini adalah offset bilangan bulat berbasis satu ke daftar urutan urutan kustom. Jika Anda menghilangkan OrderCustom, pengurutan normal akan 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. Mengurutkan berdasar baris. xlSortColumns. Mengurutkan menurut kolom.

SortMethod: XlSortMethod

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

DataOption1: XlSortDataOption

Menentukan cara mengurutkan teks dalam key1. Tidak dapat digunakan saat mengurutkan laporan PivotTable. Bisa menjadi salah satu nilai berikut XlSortDataOption : xlSortTextAsNumbers. Perlakukan teks sebagai data numerik untuk pengurutan. xlSortNormal. 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. 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. Mengurutkan data numerik dan teks secara terpisah.

Mengembalikan

Object

Contoh

Contoh kode berikut menempatkan sekumpulan bilangan bulat dalam sel A1 hingga A5 lalu menggunakan Sort metode untuk mengurutkan data dalam urutan naik.

Contoh ini untuk kustomisasi tingkat dokumen.

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

Keterangan

Pengaturan untuk Header, , Order1Order2, Order3, OrderCustom, dan Orientation disimpan, untuk lembar kerja tertentu, setiap kali Anda menggunakan metode ini. Jika Anda tidak menentukan nilai untuk argumen ini saat anda memanggil metode berikutnya, nilai yang disimpan akan digunakan. Atur argumen ini secara eksplisit setiap kali Anda menggunakan metode ini, jika Anda memilih untuk tidak menggunakan nilai yang disimpan.

String teks yang tidak dapat dikonversi ke data numerik diurutkan secara normal.

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

Parameter Opsional

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

Berlaku untuk

Bagikan melalui