DataGridViewSortCompareEventArgs Classe

Définition

Fournit des données pour l'événement 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
Héritage
DataGridViewSortCompareEventArgs

Exemples

L’exemple de code suivant illustre l’utilisation de SortCompare dans un tri sur plusieurs colonnes.The following code example demonstrates the use of SortCompare in a multiple column sort. Cet exemple fait partie d’un exemple plus complet fourni dans Comment : personnaliser le tri dans le Windows Forms contrôle 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

Remarques

Vous pouvez gérer l’événement SortCompare pour fournir un tri personnalisé.You can handle the SortCompare event to provide custom sorting. Cet événement se produit uniquement lorsque la propriété DataGridView.DataSource n’est pas définie et que la propriété DataGridView.VirtualMode a la valeur false.This event occurs only when the DataGridView.DataSource property is not set and the DataGridView.VirtualMode property is set to false. Cet événement se produit une fois pour chaque paire de cellules de la colonne en cours de tri.This event occurs once for each pair of cells in the column being sorted. Il se produit uniquement quand l’utilisateur clique sur l’en-tête d’une colonne avec une valeur de propriété DataGridViewColumn.SortMode de Automaticou lorsque vous appelez la surcharge 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. Lorsque cet événement se produit pour une colonne avec une valeur de propriété DataGridViewColumn.SortMode de Programmatic, vous devez afficher le glyphe de tri vous-même via la propriété 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.

Vous pouvez utiliser cet événement pour trier les lignes à l’aide des valeurs des cellules d’une colonne ou de plusieurs colonnes.You can use this event to sort rows using the cell values in one column or in multiple columns. Utilisez les propriétés CellValue1 et CellValue2 pour comparer les valeurs des cellules de la colonne spécifiée dans la propriété Column.Use the CellValue1 and CellValue2 properties to compare cell values in the column specified in the Column property. Utilisez les propriétés RowIndex1 et RowIndex2 pour accéder aux valeurs d’autres colonnes via la collection DataGridView.Rows.Use the RowIndex1 and RowIndex2 properties to access values in other columns through the DataGridView.Rows collection.

Constructeurs

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

Initialise une nouvelle instance de la classe DataGridViewSortCompareEventArgs.Initializes a new instance of the DataGridViewSortCompareEventArgs class.

Propriétés

CellValue1

Obtient la valeur de la première cellule à comparer.Gets the value of the first cell to compare.

CellValue2

Obtient la valeur de la deuxième cellule à comparer.Gets the value of the second cell to compare.

Column

Obtient la colonne en cours de tri.Gets the column being sorted.

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

(Hérité de HandledEventArgs)
RowIndex1

Obtient l'index de la ligne contenant la première cellule à comparer.Gets the index of the row containing the first cell to compare.

RowIndex2

Obtient l'index de la ligne contenant la deuxième cellule à comparer.Gets the index of the row containing the second cell to compare.

SortResult

Obtient ou définit une valeur indiquant l'ordre dans lequel les cellules comparées seront triées.Gets or sets a value indicating the order in which the compared cells will be sorted.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actif.Returns a string that represents the current object.

(Hérité de Object)

S’applique à

Voir aussi