DataGridViewSortCompareEventArgs Klasse

Definition

Stellt Daten für das SortCompare-Ereignis bereit.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
Vererbung
DataGridViewSortCompareEventArgs

Beispiele

Im folgenden Codebeispiel wird die Verwendung von SortCompare in einer Sortierung mit mehreren Spalten veranschaulicht.The following code example demonstrates the use of SortCompare in a multiple column sort. Dieses Beispiel ist Teil eines größeren Beispiels in Gewusst wie: Anpassen der Sortierung im Windows Forms DataGridView-SteuerElement.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

Hinweise

Sie können das- SortCompare Ereignis behandeln, um eine benutzerdefinierte Sortierung bereitzustellen.You can handle the SortCompare event to provide custom sorting. Dieses Ereignis tritt nur DataGridView.DataSource auf, wenn die-Eigenschaft nicht festgelegt ist und die- DataGridView.VirtualMode Eigenschaft auf festgelegt ist false .This event occurs only when the DataGridView.DataSource property is not set and the DataGridView.VirtualMode property is set to false. Dieses Ereignis tritt einmal für jedes Zellen Paar in der zu sortierenden Spalte auf.This event occurs once for each pair of cells in the column being sorted. Sie tritt nur auf, wenn der Benutzer auf den Header einer Spalte mit dem- DataGridViewColumn.SortMode Eigenschafts Wert klickt Automatic oder wenn Sie die-Überladung aufrufen DataGridView.Sort(DataGridViewColumn, ListSortDirection) .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. Wenn dieses Ereignis für eine Spalte mit dem- DataGridViewColumn.SortMode Eigenschafts Wert auftritt Programmatic , müssen Sie das Sortier Symbol selbst über die- DataGridViewColumnHeaderCell.SortGlyphDirection Eigenschaft anzeigen.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.

Mit diesem Ereignis können Sie Zeilen mithilfe der Zellwerte in einer Spalte oder in mehreren Spalten sortieren.You can use this event to sort rows using the cell values in one column or in multiple columns. Verwenden CellValue1 Sie die CellValue2 Eigenschaften und, um Zellwerte in der in der-Eigenschaft angegebenen Spalte zu vergleichen Column .Use the CellValue1 and CellValue2 properties to compare cell values in the column specified in the Column property. Verwenden RowIndex1 Sie die-Eigenschaft und die-Eigenschaft RowIndex2 , um über die-Auflistung auf Werte in anderen Spalten DataGridView.RowsUse the RowIndex1 and RowIndex2 properties to access values in other columns through the DataGridView.Rows collection.

Konstruktoren

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

Initialisiert eine neue Instanz der DataGridViewSortCompareEventArgs-Klasse.Initializes a new instance of the DataGridViewSortCompareEventArgs class.

Eigenschaften

CellValue1

Ruft den Wert der ersten zu vergleichenden Zelle ab.Gets the value of the first cell to compare.

CellValue2

Ruft den Wert der zweiten zu vergleichenden Zelle ab.Gets the value of the second cell to compare.

Column

Ruft die sortierte Spalte ab.Gets the column being sorted.

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.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.

(Geerbt von HandledEventArgs)
RowIndex1

Ruft den Index der Zeile ab, die die erste zu vergleichende Zelle enthält.Gets the index of the row containing the first cell to compare.

RowIndex2

Ruft den Index der Zeile ab, die die zweite zu vergleichende Zelle enthält.Gets the index of the row containing the second cell to compare.

SortResult

Ruft einen Wert ab, der die Reihenfolge angibt, in der die verglichenen Zellen sortiert werden, oder legt diesen fest.Gets or sets a value indicating the order in which the compared cells will be sorted.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch