DataGridViewSortCompareEventArgs Classe

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Fornece dados para o evento de SortCompare .

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

Exemplos

O exemplo de código a seguir demonstra o uso de em uma classificação de SortCompare várias colunas. Este exemplo faz parte de um exemplo maior fornecido em 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

Comentários

Você pode manipular o SortCompare evento para fornecer classificação personalizada. Esse evento ocorre somente quando a DataGridView.DataSource propriedade não está definida e a DataGridView.VirtualMode propriedade é definida falsecomo . Esse evento ocorre uma vez para cada par de células na coluna que está sendo classificada. Isso ocorre somente quando o usuário clica no cabeçalho de uma coluna com um DataGridViewColumn.SortMode valor de propriedade de Automaticou quando você chama a DataGridView.Sort(DataGridViewColumn, ListSortDirection) sobrecarga. Quando esse evento ocorre para uma coluna com um DataGridViewColumn.SortMode valor de propriedade de Programmatic, você deve exibir o glifo de classificação por conta própria por meio da DataGridViewColumnHeaderCell.SortGlyphDirection propriedade .

Você pode usar esse evento para classificar linhas usando os valores de célula em uma coluna ou em várias colunas. Use as CellValue1 propriedades e CellValue2 para comparar valores de célula na coluna especificada na Column propriedade . Use as RowIndex1 propriedades e RowIndex2 para acessar valores em outras colunas por meio da DataGridView.Rows coleção.

Construtores

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

Inicializa uma nova instância da classe DataGridViewSortCompareEventArgs.

Propriedades

CellValue1

Obtém o valor da primeira célula a ser comparada.
CellValue2

Obtém o valor da segunda célula a ser comparada.
Column

Obtém a coluna que está sendo classificada.
Handled

Obtém ou define um valor que indica se o manipulador de eventos tratou completamente o evento ou se o sistema deve continuar seu próprio processamento.

(Herdado de HandledEventArgs)
RowIndex1

Obtém o índice da linha que contém a primeira célula a ser comparada.
RowIndex2

Obtém o índice da linha que contém a segunda célula a ser comparada.
SortResult

Obtém ou define um valor que indica a ordem na qual as células comparadas serão classificadas.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também