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 SortCompare de 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 How to: Personnaliser le tri dans le contrôleDataGridView Windows Forms.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' SortCompare événement pour fournir un tri personnalisé.You can handle the SortCompare event to provide custom sorting. Cet événement se produit uniquement lorsque DataGridView.DataSource la propriété n’est pas définie DataGridView.VirtualMode et que la propriété falsea la valeur.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 DataGridViewColumn.SortMode d’une colonne Automaticavec une valeur de propriété ou DataGridView.Sort(DataGridViewColumn, ListSortDirection) lorsque vous appelez la surcharge.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 DataGridViewColumn.SortMode une valeur de Programmaticpropriété de, vous devez afficher le glyphe de tri DataGridViewColumnHeaderCell.SortGlyphDirection vous-même via la propriété.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 CellValue1 propriétés CellValue2 et pour comparer des valeurs de cellule dans la colonne spécifiée Column dans la propriété.Use the CellValue1 and CellValue2 properties to compare cell values in the column specified in the Column property. Utilisez les RowIndex1 propriétés RowIndex2 et pour accéder aux valeurs d’autres colonnes via DataGridView.Rows la collection.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 en cours.Returns a string that represents the current object.

(Hérité de Object)

S’applique à

Voir aussi