方法 : ASP.NET サーバー コントロールに対する検証エラー メッセージの表示を制御する
更新 : 2007 年 11 月
Microsoft Visual Web Developer では、次の表に示すように、4 種類の方法でエラー メッセージ テキストを表示できます。
表示方法 |
説明 |
---|---|
インライン |
コントロールの横 (検証コントロールが配置されている場所) にエラー メッセージを表示します。 |
概要 |
すべてのエラー メッセージを個別に一覧表示します。これは、ユーザーがページを送信した場合にだけ利用できます。オプションでエラー メッセージをメッセージ ボックスに表示できますが、この方法はダイナミック HTML (DHTML) をサポートするブラウザ以外では使用できません。 |
インラインおよび概要 |
一覧表示するエラー メッセージとインラインで表示するメッセージを異なる内容にできます。このオプションを使用すると、インラインには短いエラー メッセージを表示して一覧に詳細を表示したり、入力フィールドの横にエラー グリフを表示して一覧にエラー メッセージを表示したりできます。 |
カスタム |
独自のエラー メッセージ表示を作成できます。詳細については、「方法 : ASP.NET サーバー コントロールのサーバー側のカスタム検証メッセージを表示する」を参照してください。 |
エラー メッセージを一覧に表示する場合は、ページにコントロールを追加する必要があります。
エラー メッセージの一覧を表示するには
ページ上でエラー メッセージの一覧を表示する場所に ValidationSummary コントロールを追加します。
個別の検証コントロールの ErrorMessage プロパティおよび Display プロパティを設定します。
ValidationSummaryDisplayMode 列挙体に定義された次のいずれかの値を使用して、サマリ コントロールの DisplayMode プロパティをエラー メッセージの形式に設定します。
値
表示
BulletList
(既定値) 各エラー メッセージが箇条書き項目として表示されます。
List
各エラー メッセージがそれぞれ 1 つの行に表示されます。
SingleParagraph
各エラー メッセージが段落内の文として表示されます。
個別の検証コントロールを検証グループに関連付ける場合は、それぞれの検証グループごとに 1 つの ValidationSummary コントロールを使用する必要があります。
エラー メッセージをインラインおよび一覧で表示するには、個々の検証コントロールにプロパティのさまざまな組み合わせを設定する必要があります。
インラインのエラー メッセージおよび一覧のエラー メッセージを表示するには
前の手順で説明した ValidationSummary コントロールを追加します。
次の表に従って、各検証コントロールの ErrorMessage、Text、および Display の各プロパティを設定します。
オプション
ValidationSummary コントロールが必要
検証コントロールのプロパティ設定
個別表示だけ
不要
Display = Static または Dynamic
ErrorMessage = <error text> または Text = <error text>
一覧表示 (メッセージ ボックス オプションも含む)
必要
Display = None
ErrorMessage = <error text> または Text = <error text>
個別表示と一覧表示 (メッセージ ボックス オプションも含む)
必要
Display = Static または Dynamic
ErrorMessage = <error text for summary>
Text = <inline error text or glyph>
クライアントが DHTML をサポートするブラウザを実行している場合、エラー メッセージの一覧はメッセージ ボックスにも表示できます。
エラー メッセージの一覧をメッセージ ボックスに表示するには
ValidationSummary コントロールの ShowMessageBox プロパティを true に設定します。
ユーザーがページを送信すると、ValidationSummary コントロールとメッセージ ボックスの両方にエラーが表示されます。
メッセージ ボックスだけにエラー メッセージの一覧を表示するには、ShowSummary プロパティを false に設定します。
参照
処理手順
方法 : ASP.NET サーバー コントロールの埋め込み先メッセージのレイアウトを指定する