DataGridViewSortCompareEventArgs Klasa

Definicja

Udostępnia dane dla zdarzenia SortCompare.

public ref class DataGridViewSortCompareEventArgs : System::ComponentModel::HandledEventArgs
public class DataGridViewSortCompareEventArgs : System.ComponentModel.HandledEventArgs
type DataGridViewSortCompareEventArgs = class
    inherit HandledEventArgs
Public Class DataGridViewSortCompareEventArgs
Inherits HandledEventArgs
Dziedziczenie
DataGridViewSortCompareEventArgs

Przykłady

W poniższym przykładzie kodu pokazano użycie SortCompare funkcji w sortowaniu wielu kolumn. Ten przykład jest częścią większego przykładu przedstawionego w temacie How to: Customize Sort in the Windows Forms DataGridView Control (Dostosowywanie sortowania w kontrolce 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

Uwagi

Zdarzenie można obsłużyć w SortCompare celu zapewnienia sortowania niestandardowego. To zdarzenie występuje tylko wtedy, gdy DataGridView.DataSource właściwość nie jest ustawiona i właściwość jest ustawiona DataGridView.VirtualMode na falsewartość . To zdarzenie występuje raz dla każdej pary komórek w posortowanej kolumnie. Występuje tylko wtedy, gdy użytkownik kliknie nagłówek kolumny z wartością DataGridViewColumn.SortModeAutomaticwłaściwości lub po wywołaniu DataGridView.Sort(DataGridViewColumn, ListSortDirection) przeciążenia. Jeśli to zdarzenie występuje dla kolumny z wartością DataGridViewColumn.SortMode właściwości , Programmaticnależy wyświetlić sortowanie glif samodzielnie za pośrednictwem DataGridViewColumnHeaderCell.SortGlyphDirection właściwości.

To zdarzenie służy do sortowania wierszy przy użyciu wartości komórek w jednej kolumnie lub w wielu kolumnach. CellValue1 Użyj właściwości iCellValue2, aby porównać wartości komórek w kolumnie Column określonej we właściwości. RowIndex1 Użyj właściwości iRowIndex2, aby uzyskać dostęp do wartości w innych kolumnach za pośrednictwem kolekcjiDataGridView.Rows.

Konstruktory

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

Inicjuje nowe wystąpienie klasy DataGridViewSortCompareEventArgs.

Właściwości

CellValue1

Pobiera wartość pierwszej komórki do porównania.

CellValue2

Pobiera wartość drugiej komórki do porównania.

Column

Pobiera posortowaną kolumnę.

Handled

Pobiera lub ustawia wartość wskazującą, czy program obsługi zdarzeń całkowicie obsłuży zdarzenie, czy też system powinien kontynuować własne przetwarzanie.

(Odziedziczone po HandledEventArgs)
RowIndex1

Pobiera indeks wiersza zawierającego pierwszą komórkę do porównania.

RowIndex2

Pobiera indeks wiersza zawierającego drugą komórkę do porównania.

SortResult

Pobiera lub ustawia wartość wskazującą kolejność sortowania porównywanych komórek.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Dotyczy

Zobacz też