DataGridViewSortCompareEventArgs Класс

Определение

Предоставляет данные для события SortCompare.Provides data for the SortCompare event.

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

Примеры

В следующем примере кода показано использование SortCompare в сортировке по нескольким столбцам.The following code example demonstrates the use of SortCompare in a multiple column sort. Этот пример является частью большого примера, приведенного в разделе как настроить сортировку в элементе управления Windows Forms DataGridView.This example is part of a larger example provided in 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 выполнить обработку события, чтобы обеспечить пользовательскую сортировку.You can handle the SortCompare event to provide custom sorting. Это событие возникает только в том случае, если DataGridView.DataSource свойство не задано и DataGridView.VirtualMode свойство имеет значение false .This event occurs only when the DataGridView.DataSource property is not set and the DataGridView.VirtualMode property is set to false. Это событие происходит один раз для каждой пары ячеек в сортируемом столбце.This event occurs once for each pair of cells in the column being sorted. Это происходит только в том случае, если пользователь щелкает заголовок столбца со DataGridViewColumn.SortMode значением свойства Automatic или при вызове DataGridView.Sort(DataGridViewColumn, ListSortDirection) перегрузки.It occurs only when the user clicks the header of a column with a DataGridViewColumn.SortMode property value of Automatic, or when you call the DataGridView.Sort(DataGridViewColumn, ListSortDirection) overload. Когда это событие происходит для столбца со DataGridViewColumn.SortMode значением свойства Programmatic , необходимо самостоятельно отобразить глиф сортировки с помощью DataGridViewColumnHeaderCell.SortGlyphDirection Свойства.When this event occurs for a column with a DataGridViewColumn.SortMode property value of Programmatic, you must display the sorting glyph yourself through the DataGridViewColumnHeaderCell.SortGlyphDirection property.

Это событие можно использовать для сортировки строк с помощью значений ячеек в одном столбце или в нескольких столбцах.You can use this event to sort rows using the cell values in one column or in multiple columns. Используйте CellValue1 Свойства и CellValue2 для сравнения значений ячеек в столбце, указанном в Column свойстве.Use the CellValue1 and CellValue2 properties to compare cell values in the column specified in the Column property. Используйте RowIndex1 Свойства и RowIndex2 для доступа к значениям в других столбцах через DataGridView.Rows коллекцию.Use the RowIndex1 and RowIndex2 properties to access values in other columns through the DataGridView.Rows collection.

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

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

Инициализирует новый экземпляр класса DataGridViewSortCompareEventArgs.Initializes a new instance of the DataGridViewSortCompareEventArgs class.

Свойства

CellValue1

Получает значение первой ячейки для сравнения.Gets the value of the first cell to compare.

CellValue2

Получает значение второй ячейки для сравнения.Gets the value of the second cell to compare.

Column

Получает сортируемый столбец.Gets the column being sorted.

Handled

Получает или задает значение, показывающее, полностью ли обработчик событий обработал событие или система должна продолжить собственную обработку.Gets or sets a value that indicates whether the event handler has completely handled the event or whether the system should continue its own processing.

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

Получает индекс строки, содержащей первую ячейку для сравнения.Gets the index of the row containing the first cell to compare.

RowIndex2

Получает индекс строки, содержащей вторую ячейку для сравнения.Gets the index of the row containing the second cell to compare.

SortResult

Получает или задает значение, показывающее порядок, в котором будут сортироваться сравниваемые ячейки.Gets or sets a value indicating the order in which the compared cells will be sorted.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

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

Служит хэш-функцией по умолчанию.Serves as the default hash function.

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

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

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

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

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

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

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

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

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