【極限の知見】Windows Formsのバリデーション設計：ユーザーを迷わせない「Validating / Validated」の黄金律
「入力ミスをしたので、一旦入力をやめて『キャンセル』ボタンを押したい……。なのに、エラーメッセージが何度も出てきて、先に進めない！」
もしあなたが、開発中のアプリでこんな挙動を経験したことがあるなら、それは設計の「ライフサイクル」に対する理解が、まだ少しだけ不足しているサインかもしれません。
こんにちは。今日は、Windows Formsアプリケーション開発において、中級者への階段を登るために避けては通れない「バリデーション（入力検証）の正しい設計」についてお話ししましょう。
単に「間違っていたら警告を出す」だけなら簡単です。しかし、プロが作るシステムは、ユーザーの操作を邪魔しません。ユーザーが「間違えたことに気づいて、修正するか、あるいは諦めて画面を閉じるか」という意思決定の自由を尊重するのです。
その鍵を握るのが、`Validating` と `Validated` という2つのイベントの正しい使い分けです。
1. 陥りがちな罠：なぜ「Leave」イベントでは不十分なのか？
多くの初学者は、入力欄からフォーカスが外れた（Leaveした）瞬間にチェックを行おうとして、`Leave` イベントを使用します。しかし、これには大きな落とし穴があります。
`Leave` イベントは、「フォーカスが離れたこと」を通知するだけで、「フォーカス移動を阻止する力」を持っていません。
例えば、必須入力欄を空欄のまま次の項目へ移動しようとしても、`Leave` イベントでいくらエラーを表示しても、フォーカスはそのまま移動してしまいます。結果として、ユーザーは「どこが間違っているのか」を把握しにくくなり、データの一貫性が崩れる原因になります。
そこで登場するのが、`Validating` と `Validated` のコンビネーションです。
2. バリデーションの黄金サイクル：イベントの実行順序
Windows Formsにおけるバリデーションは、以下の厳格なステップで進行します。この流れを頭の中に描けるようになれば、設計の半分は完了したも同然です。
【イベントのライフサイクル図解】
1. ユーザーが別のコントロールをクリック（フォーカス移動の発生）
2. `Validating` イベントの発生（← ここが門番！）
- ここで「入力が正しいか」を判定します。
- もし不正なら： `e.Cancel = True` を設定します。
- → フォーカス移動がキャンセルされ、元のコントロールに留まります。
- もし正しければ： 何もしません。
3. `Validated` イベントの発生（← 成功の儀式）
- 入力が承認された後の、クリーンアップ処理やデータの確定を行います。
4. フォーカスが新しいコントロールへ移動完了
この「`Validating` で止めることができる」という性質こそが、堅牢なUIを作るための核心です。
3. 実践：ErrorProvider を使ったエレガントな実装
メッセージボックス（`MessageBox.Show`）でエラーを出すのは、実はあまり推奨されません。なぜなら、入力するたびにダイアログがポップアップするのは、ユーザーにとって非常にストレスフルだからです。
プロの現場では、`ErrorProvider` コンポーネントを使用して、コントロールの横に小さなアイコンを表示する手法を好みます。
以下に、数値のみを受け付けるテキストボックスを例にした、実戦的なコード例を示します。
“`vb.net
”’
”’ ユーザーの操作を妨げず、かつ不正なデータ入力を確実に阻止するバリデーション設計。
”’
Public Class Form1
‘ ErrorProviderをフォームに配置しておきます（デザイナー上で配置するか、コードで生成）
‘ これにより、メッセージボックスを乱発せずにエラーを視覚化できます。
Private WithEvents errorProvider1 As New ErrorProvider()
”’
”’
”’ イベント引数。e.Cancel を使うことでフォーカス移動を制御できる
Private Sub txtAge_Validating(sender As Object, e As System.ComponentModel.CancelEventArgs) Handles txtAge.Validating
Dim tb As TextBox = DirectCast(sender, TextBox)
Dim input As String = tb.Text
‘ 1. 空文字チェック
If String.IsNullOrWhiteSpace(input) Then
‘ エラーメッセージの設定と、フォーカス移動の阻止
errorProvider1.SetError(tb, “年齢を入力してください。”)
e.Cancel = True ‘ これが重要！フォーカスが移動するのを防ぐ
Return
End If
‘ 2. 数値チェック
Dim age As Integer
If Not Integer.TryParse(input, age) Then
errorProvider1.SetError(tb, “数字のみを入力してください。”)
e.Cancel = True ‘ フォーカス移動を阻止
Return
End If
‘ 3. 範囲チェック
If age < 0 OrElse age > 150 Then
errorProvider1.SetError(tb, “0から150の間で入力してください。”)
e.Cancel = True
Return
End If
‘ — 全ての検証を通過した場合 —
‘ エラー表示をクリアする
errorProvider1.SetError(tb, “”)
End Sub
”’
”’
Private Sub txtAge_Validated(sender As Object, e As EventArgs) Handles txtAge.Validated
‘ 検証をパスした後の、データの確定処理などをここに記述
‘ 例：入力された値を内部変数に格納する、など
Console.WriteLine(“入力が承認されました。”)
End Sub
End Class
“`
4. 【最重要】「キャンセルボタンの罠」を回避する `CausesValidation`
さて、ここからが「伝説のアーキテクト」への分かれ道です。
上記のコードを実装した状態で、ユーザーが「あ、やっぱりこの入力はやめよう」と思って「キャンセル」ボタンを押したとしましょう。すると、どうなるでしょうか？
1. ユーザーが「キャンセル」ボタンをクリック。
2. システムは `txtAge` からボタンへフォーカスを移そうとする。
3. `txtAge_Validating` が走り、「入力されていません！」と `e.Cancel = True` を返す。
4. フォーカスが移動できず、キャンセルボタンが押せない！
ユーザーは「キャンセルしたいのに、キャンセルできない」という、最悪のユーザー体験（UX）に陥ります。
解決策：`CausesValidation` プロパティの制御
この問題を解決する魔法のプロパティが、コントロールの `CausesValidation` です。
- 通常の入力欄（TextBoxなど）: `CausesValidation = True` (デフォルト)
- フォーカスが離れるときに、バリデーションを実行する。
- キャンセルボタンや閉じるボタン: `CausesValidation = False` に設定する。
`CausesValidation` を `False` に設定したコントロールをクリックした場合、システムは「このコントロールへの移動時にはバリデーションをスキップしていいよ」と判断します。これにより、エラー状態であっても、ユーザーは安全に画面を離れる（キャンセルする）ことができるのです。
まとめ：プロの設計思想
Windows Formsにおけるバリデーションの本質をまとめましょう。
1. `Validating` イベントで「門番」を務める: `e.Cancel = True` を使い、不正な状態でのフォーカス移動を物理的に阻止する。
2. `ErrorProvider` で優しく伝える: ユーザーを驚かせないよう、視覚的にエラーを提示する。
3. `CausesValidation` で「逃げ道」を作る: キャンセルボタンなどの非入力コントロールには、バリデーションをバイパスさせる設定を忘れない。
「正しく縛る」ことと同じくらい、「正しく解放する」ことは重要です。これらをマスターすれば、あなたの作るアプリケーションは、驚くほど使いやすく、堅牢なものへと進化します。
ここをクリアすれば、Visual Basic (VB / VB.NET) のUI設計の基本はバッチリですよ。自信を持って、次のステップへ進んでくださいね！
