DataGridViewSortCompareEventArgs Класс

  • Ссылка

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll

Предоставляет данные о событии SortCompare.

public ref class DataGridViewSortCompareEventArgs : System::ComponentModel::HandledEventArgs
public class DataGridViewSortCompareEventArgs : System.ComponentModel.HandledEventArgs
type DataGridViewSortCompareEventArgs = class
    inherit HandledEventArgs
Public Class DataGridViewSortCompareEventArgs
Inherits HandledEventArgs
Наследование
Object
EventArgs
HandledEventArgs
DataGridViewSortCompareEventArgs

Примеры

В следующем примере кода показано использование SortCompare в сортировке по нескольким столбцам. Этот пример является частью более крупного примера, приведенного в разделе How to: Customize Sorting in the Windows Forms DataGridView Control.

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

Комментарии

Вы можете обработать SortCompare событие для предоставления настраиваемой сортировки. Это событие возникает только в том случае, DataGridView.DataSource если свойство не задано и DataGridView.VirtualMode свойство имеет значение false. Это событие возникает один раз для каждой пары отсортированных ячеек в столбце. Это происходит только при щелчке пользователем заголовка столбца со значением DataGridViewColumn.SortModeAutomaticсвойства или при вызове перегрузки DataGridView.Sort(DataGridViewColumn, ListSortDirection) . При возникновении этого события для столбца со значением DataGridViewColumn.SortModeProgrammaticсвойства необходимо отобразить глиф сортировки самостоятельно через DataGridViewColumnHeaderCell.SortGlyphDirection свойство .

Это событие можно использовать для сортировки строк с помощью значений ячеек в одном или нескольких столбцах. CellValue1 Используйте свойства и CellValue2 для сравнения значений ячеек в столбце, указанном в свойстве Column . RowIndex1 Используйте свойства и RowIndex2 для доступа к значениям в других столбцах через коллекциюDataGridView.Rows.

Конструкторы

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

Инициализирует новый экземпляр класса DataGridViewSortCompareEventArgs.

Свойства

CellValue1

Получает значение первой ячейки для сравнения.
CellValue2

Получает значение второй ячейки для сравнения.
Column

Получает сортируемый столбец.
Handled

Получает или задает значение, показывающее, полностью ли обработчик событий обработал событие или система должна продолжить собственную обработку.

(Унаследовано от HandledEventArgs)
RowIndex1

Получает индекс строки, содержащей первую ячейку для сравнения.
RowIndex2

Получает индекс строки, содержащей вторую ячейку для сравнения.
SortResult

Получает или задает значение, показывающее порядок, в котором будут сортироваться сравниваемые ячейки.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Применяется к

См. также раздел