Bagikan melalui

DataGridViewSortCompareEventArgs Kelas

  • Referensi

Definisi

Ruang nama:
System.Windows.Forms
Rakitan:
System.Windows.Forms.dll

Menyediakan data untuk peristiwa tersebut SortCompare .

public ref class DataGridViewSortCompareEventArgs : System::ComponentModel::HandledEventArgs
public class DataGridViewSortCompareEventArgs : System.ComponentModel.HandledEventArgs
type DataGridViewSortCompareEventArgs = class
    inherit HandledEventArgs
Public Class DataGridViewSortCompareEventArgs
Inherits HandledEventArgs
Warisan
Object
EventArgs
HandledEventArgs
DataGridViewSortCompareEventArgs

Contoh

Contoh kode berikut menunjukkan penggunaan dalam pengurutan SortCompare beberapa kolom. Contoh ini adalah bagian dari contoh yang lebih besar yang disediakan dalam Cara: Menyesuaikan Pengurutan di kontrol Formulir Windows DataGridView.

private void dataGridView1_SortCompare(object sender,
    DataGridViewSortCompareEventArgs e)
{
    // Try to sort based on the cells in the current column.
    e.SortResult = System.String.Compare(
        e.CellValue1.ToString(), e.CellValue2.ToString());

    // If the cells are equal, sort based on the ID column.
    if (e.SortResult == 0 && e.Column.Name != "ID")
    {
        e.SortResult = System.String.Compare(
            dataGridView1.Rows[e.RowIndex1].Cells["ID"].Value.ToString(),
            dataGridView1.Rows[e.RowIndex2].Cells["ID"].Value.ToString());
    }
    e.Handled = true;
}

Private Sub DataGridView1_SortCompare( _
    ByVal sender As Object, ByVal e As DataGridViewSortCompareEventArgs) _
    Handles DataGridView1.SortCompare

    ' Try to sort based on the contents of the cell in the current column.
    e.SortResult = System.String.Compare(e.CellValue1.ToString(), _
        e.CellValue2.ToString())

    ' If the cells are equal, sort based on the ID column.
    If (e.SortResult = 0) AndAlso Not (e.Column.Name = "ID") Then
        e.SortResult = System.String.Compare( _
            DataGridView1.Rows(e.RowIndex1).Cells("ID").Value.ToString(), _
            DataGridView1.Rows(e.RowIndex2).Cells("ID").Value.ToString())
    End If

    e.Handled = True

End Sub

Keterangan

Anda dapat menangani SortCompare peristiwa untuk menyediakan pengurutan kustom. Peristiwa ini hanya terjadi ketika DataGridView.DataSource properti tidak diatur dan DataGridView.VirtualMode properti diatur ke false. Kejadian ini terjadi sekali untuk setiap pasangan sel dalam kolom yang sedang diurutkan. Ini terjadi hanya ketika pengguna mengklik header kolom dengan DataGridViewColumn.SortMode nilai Automaticproperti , atau saat Anda memanggil DataGridView.Sort(DataGridViewColumn, ListSortDirection) kelebihan beban. Ketika peristiwa ini terjadi untuk kolom dengan DataGridViewColumn.SortMode nilai Programmaticproperti , Anda harus menampilkan glyph pengurutan sendiri melalui DataGridViewColumnHeaderCell.SortGlyphDirection properti .

Anda bisa menggunakan kejadian ini untuk mengurutkan baris menggunakan nilai sel dalam satu kolom atau di beberapa kolom. CellValue1 Gunakan properti dan CellValue2 untuk membandingkan nilai sel dalam kolom yang ditentukan dalam Column properti . RowIndex1 Gunakan properti dan RowIndex2 untuk mengakses nilai di kolom lain melalui DataGridView.Rows koleksi.

Konstruktor

DataGridViewSortCompareEventArgs(DataGridViewColumn, Object, Object, Int32, Int32)

Menginisialisasi instans baru kelas DataGridViewSortCompareEventArgs.

Properti

CellValue1

Mendapatkan nilai sel pertama yang akan dibandingkan.
CellValue2

Mendapatkan nilai sel kedua untuk dibandingkan.
Column

Mendapatkan kolom yang sedang diurutkan.
Handled

Mendapatkan atau menetapkan nilai yang menunjukkan apakah penanganan aktivitas telah sepenuhnya menangani peristiwa atau apakah sistem harus melanjutkan pemrosesannya sendiri.

(Diperoleh dari HandledEventArgs)
RowIndex1

Mendapatkan indeks baris yang berisi sel pertama yang akan dibandingkan.
RowIndex2

Mendapatkan indeks baris yang berisi sel kedua untuk dibandingkan.
SortResult

Mendapatkan atau mengatur nilai yang menunjukkan urutan di mana sel yang dibandingkan akan diurutkan.

Metode

Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetType()

Mendapatkan dari instans Type saat ini.

(Diperoleh dari Object)
MemberwiseClone()

Membuat salinan dangkal dari saat ini Object.

(Diperoleh dari Object)
ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)

Berlaku untuk

Lihat juga