DataGridViewSortCompareEventArgs DataGridViewSortCompareEventArgs DataGridViewSortCompareEventArgs DataGridViewSortCompareEventArgs Class

정의

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
상속
DataGridViewSortCompareEventArgsDataGridViewSortCompareEventArgsDataGridViewSortCompareEventArgsDataGridViewSortCompareEventArgs

예제

다음 코드 예제에서는 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. 사용 합니다 CellValue1CellValue2 속성에 지정 된 열에서 셀 값을 비교 하는 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(DataGridViewColumn, Object, Object, Int32, Int32) DataGridViewSortCompareEventArgs(DataGridViewColumn, Object, Object, Int32, Int32) DataGridViewSortCompareEventArgs(DataGridViewColumn, Object, Object, Int32, Int32)

DataGridViewSortCompareEventArgs 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DataGridViewSortCompareEventArgs class.

속성

CellValue1 CellValue1 CellValue1 CellValue1

비교할 첫째 셀의 값을 가져옵니다.Gets the value of the first cell to compare.

CellValue2 CellValue2 CellValue2 CellValue2

비교할 둘째 셀의 값을 가져옵니다.Gets the value of the second cell to compare.

Column Column Column Column

정렬할 열을 가져옵니다.Gets the column being sorted.

Handled Handled Handled 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.

(Inherited from HandledEventArgs)
RowIndex1 RowIndex1 RowIndex1 RowIndex1

비교할 첫째 셀이 포함된 행의 인덱스를 가져옵니다.Gets the index of the row containing the first cell to compare.

RowIndex2 RowIndex2 RowIndex2 RowIndex2

비교할 둘째 셀이 포함된 행의 인덱스를 가져옵니다.Gets the index of the row containing the second cell to compare.

SortResult SortResult SortResult SortResult

비교된 셀이 정렬될 순서를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating the order in which the compared cells will be sorted.

메서드

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)

적용 대상

추가 정보