DataGridViewSortCompareEventArgs Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt Daten für das SortCompare-Ereignis bereit.
public ref class DataGridViewSortCompareEventArgs : System::ComponentModel::HandledEventArgs
public class DataGridViewSortCompareEventArgs : System.ComponentModel.HandledEventArgs
type DataGridViewSortCompareEventArgs = class
inherit HandledEventArgs
Public Class DataGridViewSortCompareEventArgs
Inherits HandledEventArgs
- Vererbung
Beispiele
Im folgenden Codebeispiel wird die Verwendung von SortCompare in einer Sortierung mit mehreren Spalten veranschaulicht. Dieses Beispiel ist Teil eines größeren Beispiels unter Gewusst wie: Anpassen der Sortierung im Windows Forms DataGridView-Steuerelements.
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
Hinweise
Sie können das SortCompare Ereignis behandeln, um eine benutzerdefinierte Sortierung bereitzustellen. Dieses Ereignis tritt nur auf, wenn die DataGridView.DataSource -Eigenschaft nicht festgelegt und die DataGridView.VirtualMode -Eigenschaft auf false
festgelegt ist. Dieses Ereignis tritt einmal für jedes Zellpaar in der Spalte auf, die sortiert wird. Dies tritt nur auf, wenn der Benutzer auf die Kopfzeile einer Spalte mit dem DataGridViewColumn.SortMode Eigenschaftswert klickt Automaticoder wenn Sie die DataGridView.Sort(DataGridViewColumn, ListSortDirection) Überladung aufrufen. Wenn dieses Ereignis für eine Spalte mit dem DataGridViewColumn.SortMode Eigenschaftswert auftritt Programmatic, müssen Sie die Sortier-Glyphe selbst über die DataGridViewColumnHeaderCell.SortGlyphDirection -Eigenschaft anzeigen.
Sie können dieses Ereignis verwenden, um Zeilen mithilfe der Zellwerte in einer Spalte oder in mehreren Spalten zu sortieren. Verwenden Sie die CellValue1 Eigenschaften und CellValue2 , um Zellwerte in der in der Column -Eigenschaft angegebenen Spalte zu vergleichen. Verwenden Sie die RowIndex1 Eigenschaften und RowIndex2 , um über die DataGridView.Rows Auflistung auf Werte in anderen Spalten zuzugreifen.
Konstruktoren
DataGridViewSortCompareEventArgs(DataGridViewColumn, Object, Object, Int32, Int32) |
Initialisiert eine neue Instanz der DataGridViewSortCompareEventArgs-Klasse. |
Eigenschaften
CellValue1 |
Ruft den Wert der ersten zu vergleichenden Zelle ab. |
CellValue2 |
Ruft den Wert der zweiten zu vergleichenden Zelle ab. |
Column |
Ruft die sortierte Spalte ab. |
Handled |
Ruft einen Wert ab, der angibt, ob der Ereignishandler das Ereignis vollständig behandelt hat oder ob das System mit der eigenen Verarbeitung fortfahren soll, oder legt diesen Wert fest. (Geerbt von HandledEventArgs) |
RowIndex1 |
Ruft den Index der Zeile ab, die die erste zu vergleichende Zelle enthält. |
RowIndex2 |
Ruft den Index der Zeile ab, die die zweite zu vergleichende Zelle enthält. |
SortResult |
Ruft einen Wert ab, der die Reihenfolge angibt, in der die verglichenen Zellen sortiert werden, oder legt diesen fest. |
Methoden
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |