DataGridView.RowValidating イベントとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

DataGridView.RowValidating イベント

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

行が検証を行っているときに発生します。

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

Visual Basic (宣言)

Public Event RowValidating As
 DataGridViewCellCancelEventHandler

Visual Basic (使用法)

Dim instance As DataGridView
Dim handler As DataGridViewCellCancelEventHandler

AddHandler instance.RowValidating, handler

public event DataGridViewCellCancelEventHandler RowValidating

C++

public:
event DataGridViewCellCancelEventHandler^ RowValidating {
    void add (DataGridViewCellCancelEventHandler^ value);
    void remove (DataGridViewCellCancelEventHandler^ value);
}

/** @event */
public void add_RowValidating (DataGridViewCellCancelEventHandler
 value)

/** @event */
public void remove_RowValidating (DataGridViewCellCancelEventHandler
 value)

JScript

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

解説

このイベントは、Validating イベントに似ています。行のすべての値に対して検証を実行するには、このイベントを使用します。このイベントを使用すると、DataGridView がデータバインドの場合に行の変更の書き込みをキャンセルできます。

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

使用例

RowValidating を使用して、有効な追跡日およびリリース日が入力されたかどうかを確認するコード例を次に示します。

Visual Basic

Private Sub ValidateByRow(ByVal
 sender As Object, _
    ByVal data As DataGridViewCellCancelEventArgs)
 _
    Handles songsDataGridView.RowValidating

    Dim row As DataGridViewRow = _
        songsDataGridView.Rows(data.RowIndex)
    Dim trackCell As DataGridViewCell = _
        row.Cells(songsDataGridView.Columns("Track").Index)
    Dim dateCell As DataGridViewCell = _
        row.Cells(songsDataGridView.Columns("Release Date").Index)
    data.Cancel = Not (IsTrackGood(trackCell) _
        AndAlso IsDateGood(dateCell))
End Sub

Private Function IsTrackGood(ByRef
 cell As DataGridViewCell) As Boolean

    If cell.Value.ToString().Length = 0 Then
        cell.ErrorText = "Please enter a track"
        songsDataGridView.Rows(cell.RowIndex).ErrorText = _
            "Please enter a track"
        Return False
    ElseIf cell.Value.ToString().Equals("0")
 Then
        cell.ErrorText = "Zero is not a valid track"
        songsDataGridView.Rows(cell.RowIndex).ErrorText = _
            "Zero is not a valid track"
        Return False
    ElseIf Not Integer.TryParse(
 _
        cell.Value.ToString(), New Integer())
 Then
        cell.ErrorText = "A Track must be a number"
        songsDataGridView.Rows(cell.RowIndex).ErrorText = _
            "A Track must be a number"
        Return False
    End If
    Return True
End Function

Private Function IsDateGood(ByRef
 cell As DataGridViewCell) As Boolean

    If cell.Value Is Nothing
 Then
        cell.ErrorText = "Missing date"
        songsDataGridView.Rows(cell.RowIndex).ErrorText = _
            "Missing date"
        Return False
    Else
        Try
            DateTime.Parse(cell.Value.ToString())
        Catch ex As FormatException

            cell.ErrorText = "Invalid format"
            songsDataGridView.Rows(cell.RowIndex).ErrorText = _
                "Invalid format"

            Return False
        End Try
    End If
    Return True
End Function