DataGridViewSortCompareEventArgs Classe

Définition

Fournit des données pour l'événement SortCompare.

public ref class DataGridViewSortCompareEventArgs : System::ComponentModel::HandledEventArgs
public class DataGridViewSortCompareEventArgs : System.ComponentModel.HandledEventArgs
type DataGridViewSortCompareEventArgs = class
    inherit HandledEventArgs
Public Class DataGridViewSortCompareEventArgs
Inherits HandledEventArgs
Héritage
DataGridViewSortCompareEventArgs

Exemples

L’exemple de code suivant illustre l’utilisation de SortCompare dans un tri de plusieurs colonnes. Cet exemple fait partie d’un exemple plus large fourni dans How to: Customize Triing 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

Remarques

Vous pouvez gérer l’événement SortCompare pour fournir un tri personnalisé. Cet événement se produit uniquement lorsque la DataGridView.DataSource propriété n’est pas définie et que la propriété a la DataGridView.VirtualModefalsevaleur . Cet événement se produit une fois pour chaque paire de cellules de la colonne triée. Elle se produit uniquement lorsque l’utilisateur clique sur l’en-tête d’une colonne avec la DataGridViewColumn.SortMode valeur de Automaticpropriété , ou lorsque vous appelez la DataGridView.Sort(DataGridViewColumn, ListSortDirection) surcharge. Lorsque cet événement se produit pour une colonne avec la DataGridViewColumn.SortMode valeur de Programmaticpropriété , vous devez afficher le glyphe de tri vous-même via la DataGridViewColumnHeaderCell.SortGlyphDirection propriété .

Vous pouvez utiliser cet événement pour trier des lignes à l’aide des valeurs de cellule d’une colonne ou de plusieurs colonnes. Utilisez les CellValue1 propriétés et CellValue2 pour comparer les valeurs de cellule dans la colonne spécifiée dans la Column propriété . Utilisez les RowIndex1 propriétés et RowIndex2 pour accéder aux valeurs d’autres colonnes via la DataGridView.Rows collection.

Constructeurs

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

Initialise une nouvelle instance de la classe DataGridViewSortCompareEventArgs.

Propriétés

CellValue1

Obtient la valeur de la première cellule à comparer.

CellValue2

Obtient la valeur de la deuxième cellule à comparer.

Column

Obtient la colonne en cours de tri.

Handled

Obtient ou définit une valeur qui indique si le gestionnaire d'événements a complètement géré l'événement ou si le système doit continuer son propre traitement.

(Hérité de HandledEventArgs)
RowIndex1

Obtient l'index de la ligne contenant la première cellule à comparer.

RowIndex2

Obtient l'index de la ligne contenant la deuxième cellule à comparer.

SortResult

Obtient ou définit une valeur indiquant l'ordre dans lequel les cellules comparées seront triées.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à

Voir aussi