DataGridViewSortCompareEventHandler デリゲート

.NET Framework クラス ライブラリ リファレンス

DataGridViewSortCompareEventHandler デリゲート

メモ : このデリゲートは、.NET Framework version 2.0 で新しく追加されたものです。

DataGridView コントロールの SortCompare イベントを処理するメソッドを表します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Delegate Sub DataGridViewSortCompareEventHandler
 ( _
    sender As Object, _
    e As DataGridViewSortCompareEventArgs _
)

Visual Basic (使用法)

Dim instance As New DataGridViewSortCompareEventHandler(AddressOf
 HandlerMethod)

C#

public delegate void DataGridViewSortCompareEventHandler
 (
    Object sender,
    DataGridViewSortCompareEventArgs e
)

C++

public delegate void DataGridViewSortCompareEventHandler
 (
    Object^ sender, 
    DataGridViewSortCompareEventArgs^ e
)

J#

/** @delegate */
public delegate void DataGridViewSortCompareEventHandler
 (
    Object sender, 
    DataGridViewSortCompareEventArgs e
)

JScript

JScript では、デリゲートは使用できますが、新規に宣言することはできません。

パラメータ

sender

イベントのソース。

e

イベント データを格納している DataGridViewSortCompareEventArgs。

解説

DataGridViewSortCompareEventHandler デリゲートを作成する場合は、イベントを処理するメソッドを識別してください。イベントをイベント ハンドラに関連付けるには、デリゲートのインスタンスをイベントに追加します。デリゲートを削除しない限り、そのイベントが発生すると常にイベント ハンドラが呼び出されます。イベント ハンドラ デリゲートの詳細については、「イベントとデリゲート」を参照してください。

使用例

複数の列の並べ替えで SortCompare を使用する方法を次のコード例に示します。この例は「方法 : Windows フォーム DataGridView コントロールの並べ替え機能をカスタマイズする」で取り上げている例の一部です。

Visual Basic

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

C#

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;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
System.Windows.Forms 名前空間
DataGridView クラス
DataGridView.SortCompare イベント
DataGridViewSortCompareEventArgs クラス
その他の技術情報
方法 : Windows フォーム DataGridView コントロールの並べ替え機能をカスタマイズする