DataGridView.CellValidating イベント

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

DataGridView.CellValidating イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

セルが入力フォーカスを失い、内容の検証が有効になった場合に発生します。

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

Visual Basic (宣言)

Public Event CellValidating As
 DataGridViewCellValidatingEventHandler

Visual Basic (使用法)

Dim instance As DataGridView
Dim handler As DataGridViewCellValidatingEventHandler

AddHandler instance.CellValidating, handler

C#

public event DataGridViewCellValidatingEventHandler CellValidating

C++

public:
event DataGridViewCellValidatingEventHandler^ CellValidating {
    void add (DataGridViewCellValidatingEventHandler^ value);
    void remove (DataGridViewCellValidatingEventHandler^ value);
}

J#

/** @event */
public void add_CellValidating (DataGridViewCellValidatingEventHandler
 value)

/** @event */
public void remove_CellValidating (DataGridViewCellValidatingEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

このイベントをキャンセルすると、現在のセルへの変更がキャンセルされます。このイベントがデータ バインド モードでキャンセルされた場合、新しい値が、基になるデータ ソースにプッシュされることはありません。このイベントが仮想モードでキャンセルされた場合、CellValuePushed イベントは発生しません。

検証後処理を実行するには、CellValidated イベントを処理します。

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

CellValidating イベントを処理して、ユーザーが正の整数だけを入力するようにするコード例を次に示します。この例は VirtualMode のリファレンス トピックで取り上げている例の一部分です。

Visual Basic

Private Sub dataGridView1_CellValidating(ByVal
 sender As Object, _
    ByVal e _
    As DataGridViewCellValidatingEventArgs) _
    Handles dataGridView1.CellValidating

    Me.dataGridView1.Rows(e.RowIndex).ErrorText = ""
    Dim newInteger As Integer

    ' Don't try to validate the 'new row' until finished 
    ' editing since there
    ' is not any point in validating its initial value.
    If dataGridView1.Rows(e.RowIndex).IsNewRow Then
 Return
    If Not Integer.TryParse(e.FormattedValue.ToString(),
 newInteger) _
        OrElse newInteger < 0 Then

        e.Cancel = True
        Me.dataGridView1.Rows(e.RowIndex).ErrorText = "the
 value must be a non-negative integer"

    End If
End Sub

C#

private void dataGridView1_CellValidating(object
 sender,
    DataGridViewCellValidatingEventArgs e)
{
    dataGridView1.Rows[e.RowIndex].ErrorText = "";
    int newInteger;

    // Don't try to validate the 'new row' until finished 
    // editing since there
    // is not any point in validating its initial value.
    if (dataGridView1.Rows[e.RowIndex].IsNewRow) { return;
 }
    if (!int.TryParse(e.FormattedValue.ToString()
,
        out newInteger) || newInteger < 0)
    {
        e.Cancel = true;
        dataGridView1.Rows[e.RowIndex].ErrorText = "the value must be a non-negative
 integer";
    }
}

C++

void VirtualConnector::dataGridView1_CellValidating
    (Object^ sender, DataGridViewCellValidatingEventArgs^ e)
{
    int newInteger;

    // Don't try to validate the 'new row' until finished 
    // editing since there
    // is not any point in validating its initial value.
    if (dataGridView1->Rows[e->RowIndex]->IsNewRow) 
    {
        return; 
    }
    if (!Int32::TryParse(e->FormattedValue->ToString(),
 
        newInteger) || (newInteger < 0))
    {
        e->Cancel = true;
    }
}

J#

private void dataGridView1_CellValidating(Object
 sender,
    DataGridViewCellValidatingEventArgs e)
{
    int newInteger = 0;
    // Don't try to validate the 'new row' until finished 
    // editing since there
    // is not any point in validating its initial value.
    if (dataGridView1.get_Rows().get_Item(
        e.get_RowIndex()).get_IsNewRow()) {
        return;
    }
    if (!(Int32.TryParse(e.get_FormattedValue().ToString(), newInteger))
 
        || newInteger < 0) {
        e.set_Cancel(true);
    }
} //dataGridView1_CellValidating

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
DataGridView クラス
DataGridView メンバ
System.Windows.Forms 名前空間
DataGridViewCellValidatingEventHandler
DataGridViewCellValidatingEventArgs
DataGridView.CellValidated イベント
DataGridViewCell
OnCellValidating
その他の技術情報
DataGridView コントロール (Windows フォーム)