DataGridViewSortCompareEventArgs Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
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) |