DataGridViewSortCompareEventArgs Klasse

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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
Object
EventArgs
HandledEventArgs
DataGridViewSortCompareEventArgs

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 falsefestgelegt 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)

Gilt für:

Weitere Informationen