DataGridViewSortCompareEventArgs Classe

Definizione

Fornisce i dati per l'evento SortCompare.

public ref class DataGridViewSortCompareEventArgs : System::ComponentModel::HandledEventArgs
public class DataGridViewSortCompareEventArgs : System.ComponentModel.HandledEventArgs
type DataGridViewSortCompareEventArgs = class
    inherit HandledEventArgs
Public Class DataGridViewSortCompareEventArgs
Inherits HandledEventArgs
Ereditarietà
DataGridViewSortCompareEventArgs

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di SortCompare in un ordinamento a più colonne. Questo esempio fa parte di un esempio più ampio fornito in Procedura: Personalizzare l'ordinamento nel controllo DataGridView Windows Forms.

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

Commenti

È possibile gestire l'evento per fornire l'ordinamento SortCompare personalizzato. Questo evento si verifica solo quando la DataGridView.DataSource proprietà non è impostata e la DataGridView.VirtualMode proprietà è impostata su false. Questo evento si verifica una volta per ogni coppia di celle nella colonna da ordinare. Si verifica solo quando l'utente fa clic sull'intestazione di una colonna con un DataGridViewColumn.SortMode valore della Automaticproprietà o quando si chiama l'overload DataGridView.Sort(DataGridViewColumn, ListSortDirection) . Quando questo evento si verifica per una colonna con un DataGridViewColumn.SortMode valore della proprietà , Programmaticè necessario visualizzare il glifo di ordinamento tramite la DataGridViewColumnHeaderCell.SortGlyphDirection proprietà .

È possibile usare questo evento per ordinare le righe usando i valori delle celle in una colonna o in più colonne. Utilizzare le CellValue1 proprietà e CellValue2 per confrontare i valori delle celle nella colonna specificata nella Column proprietà . Utilizzare le RowIndex1 proprietà e RowIndex2 per accedere ai valori in altre colonne tramite l'insieme DataGridView.Rows .

Costruttori

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

Inizializza una nuova istanza della classe DataGridViewSortCompareEventArgs.

Proprietà

CellValue1

Ottiene il valore della prima cella da confrontare.

CellValue2

Ottiene il valore della seconda cella da confrontare.

Column

Ottiene la colonna da ordinare.

Handled

Ottiene o imposta un valore che indica se il gestore eventi ha gestito completamente l'evento o se il sistema deve proseguire la propria elaborazione.

(Ereditato da HandledEventArgs)
RowIndex1

Ottiene l'indice della riga contenente la prima cella da confrontare.

RowIndex2

Ottiene l'indice della riga contenente la seconda cella da confrontare.

SortResult

Ottiene o imposta un valore che indica l'ordine in cui verranno disposte le celle confrontate.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche