表示されないコントロール : コンポーネントを使用する

[アーティクル]
09/30/2008

更新 : 2007 年 11 月

Windows フォームアプリケーションで特定のタスクを実行するために使用できる、さまざまなコンポーネントがあります。たとえば、ErrorProvider コンポーネントは Windows フォームのコントロールに入力されたデータを検証するために使用できます。コンポーネントはツールボックスから選択でき、コントロールをドラッグするのと同じように Windows フォームにドラッグできます。ただし、コントロールとコンポーネントには大きな違いがあります。コンポーネントは通常、ユーザーインターフェイスを持たないので、フォーム上に表示されないという点です。

コンポーネントをフォームにドラッグすると、コンポーネントはデザインビューの下部領域のコンポーネントトレイに追加されます。ツールボックスの [コンポーネント] タブには、使用できるさまざまなコンポーネントが一覧表示されます。[ダイアログ]、[データ]、[メニューとツールバー] などのタブにも他のコンポーネントがあります。

このレッスンでは、いくつかの TextBox コントロールを Windows フォームに追加します。次に、ErrorProvider コンポーネントを使用して、これらのテキストボックスの 1 つに入力されたデータを検証できるようにします。ユーザーが入力したデータが有効であることを確認するには、TextBox などのコントロールの Validating イベントハンドラにコードを記述します。データが無効の場合は、コントロールの横にエラーアイコンが表示されます。ユーザーは、エラーアイコンにマウスポインタを置くことにより、エラーを参照できます。

やってみよう

ErrorProvider コンポーネントを使用してデータを検証するには

[ファイル] メニューの [新規作成] をポイントし、[プロジェクト] をクリックします。

[新しいプロジェクト] ダイアログボックスが表示されます。
[Windows フォームアプリケーション] をクリックし、[OK] をクリックします。

新しい Windows フォームプロジェクトが開きます。
フォームに Label コントロールを追加し (既定の名前「Label1」はそのまま)、コントロールの Text プロパティを「Name」に変更します。
Label コントロールの横に TextBox コントロールを追加します (既定の名前「TextBox1」はそのまま)。
フォームにもう 1 つ Label コントロールを追加し (既定の名前「Label2」はそのまま)、コントロールの Text プロパティを「Age」に変更します。
この Label コントロールの横に TextBox コントロールを追加します (既定の名前「TextBox2」はそのまま)。
ツールボックスの [コンポーネント] タブから、ErrorProvider コンポーネントをフォームにドラッグします (既定の名前「ErrorProvider1」はそのまま)。

コンポーネントがコンポーネントトレイに追加されます。
フォームを右クリックし、コードエディタを開きます。次に、[コードの表示] をクリックします。
コードエディタで、[クラス名] ドロップダウンリストの TextBox2 をクリックします。
[メソッド名] ドロップダウンリストで Validating をクリックして、イベントハンドラを作成します。
TextBox2_Validating イベントハンドラに次のコードを追加します。このコードは、TextBox2 に入力されたデータが数値かどうかをチェックします。数値でなかった場合、コードは ErrorProvider コンポーネントのエラーメッセージを設定します。
```
If Not IsNumeric(TextBox2.Text) Then
    ErrorProvider1.SetError(TextBox2, _
        "You must enter a numeric value.")
Else
    ErrorProvider1.SetError(TextBox2, "")
End If
```
F5 キーを押してプログラムを実行します。
フォームが表示されたら、最初のテキストボックスに自分の名前を入力します。2 番目のテキストボックスに自分の好きな色を入力し、Tab キーを押します。

TextBox2 の横にエラーアイコンが表示されます。
エラーアイコンにマウスポインタを置くと、エラーテキストが表示されます。
このテキストボックスに自分の年齢を数字で入力し、Tab キーを押します。

エラーアイコンが消えます。