DataGridViewSortCompareEventArgs.SortResult Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft einen Wert ab, der die Reihenfolge angibt, in der die verglichenen Zellen sortiert werden, oder legt diesen fest.

public:
 property int SortResult { int get(); void set(int value); };

public int SortResult { get; set; }

member this.SortResult : int with get, set

Public Property SortResult As Integer

Eigenschaftswert

Int32

Dieser Wert ist kleiner als 0 (null), wenn nach der Sortierung die erste Zelle vor der zweiten Zelle steht; 0 (null), wenn die erste Zelle und die zweite Zelle übereinstimmende Werte aufweisen und größer als 0 (null), wenn nach der Sortierung die zweite Zelle vor der ersten Zelle steht.

Beispiele

Im folgenden Codebeispiel wird die Verwendung von SortResult 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

Das Festlegen dieses Werts ist in der Regel der letzte Vorgang, den Sie in einem Handler für das DataGridView.SortCompare Ereignis ausführen. Sie legen diesen Wert in der Regel auf den Rückgabewert einer Vergleichsmethode wie String.Comparefest.

Weitere Informationen

• DataGridView
• SortCompare
• Compare
• Vorgehensweise: Anpassen der Sortierung im DataGridView-Steuerelement in Windows Forms