DataGridViewSortCompareEventArgs.SortResult DataGridViewSortCompareEventArgs.SortResult DataGridViewSortCompareEventArgs.SortResult DataGridViewSortCompareEventArgs.SortResult Property

定義

比較されたセルを並べ替える順序を示す値を取得または設定します。Gets or sets a value indicating the order in which the compared cells will be sorted.

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

プロパティ値

最初のセルを 2 番目のセルよりも前に配置する場合は 0 未満。最初のセルと 2 番目のセルの値が同じである場合は 0。2 番目のセルを最初のセルよりも前に配置する場合は 0 を超える値。Less than zero if the first cell will be sorted before the second cell; zero if the first cell and second cell have equivalent values; greater than zero if the second cell will be sorted before the first cell.

次のコード例では、複数SortResult列の並べ替えでを使用する方法を示します。The following code example demonstrates the use of SortResult in a multiple column sort. この例は、次の方法で提供される大規模な例の一部です。Windows フォーム DataGridView コントロールで並べ替えをカスタマイズします。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

注釈

通常、この値を設定すると、 DataGridView.SortCompareイベントのハンドラーで実行する最後の操作になります。Setting this value is typically the last operation you will perform in a handler for the DataGridView.SortCompare event. 通常、この値は、などString.Compareの比較メソッドの戻り値に設定します。You will typically set this value to the return value of a comparison method such as String.Compare.

適用対象

こちらもご覧ください