Практическое руководство. Управление отображением сообщений об ошибках проверки для серверных элементов управления ASP.NET
Обновлен: Ноябрь 2007
В Microsoft Visual Web Developer можно отобразить текст сообщения об ошибке четырьмя различными способами, описанными в следующей таблице.
Метод отображения |
Описание |
|---|---|
Встроенный |
Сообщение об ошибке отображается рядом с элементом управления, в месте расположения проверяющего элемента управления. |
Сводка |
Сообщение об ошибке отображается в отдельной сводке всех ошибок, которая доступна, только когда пользователь отправляет страницу. Кроме того, сообщение об ошибке может отображаться в окне сообщения, но данный параметр доступен только в обозревателях, поддерживающих динамический HTML (DHTML). |
Встроенный и в сводке |
Сообщение об ошибках в сводке может отличаться от встроенного. Этот параметр служит для отображения более короткого встроенного сообщения об ошибках и более подробного — в сводке, а также для отображения глифа ошибки в сводке рядом с полем ввода и сообщением об ошибках в сводке. |
Пользовательское |
Можно создать собственное отображение сообщений об ошибках. Дополнительные сведения см. в разделе Практическое руководство. Отображение настраиваемых сообщений о проверке на стороне сервера для серверных элементов управления ASP.NET. |
Чтобы отобразить сводку сообщений об ошибках, необходимо добавить на страницу элемент управления.
Отображение сводки сообщений об ошибках
Добавьте на страницу элемент управления ValidationSummary в расположение, в котором должны отображаться собранные сообщения об ошибках.
Задайте свойства ErrorMessage и Display отдельных проверяющих элементов управления.
Задайте для свойства DisplayMode элемента управления сводкой форматирование сообщений об ошибках с помощью одного из следующих значений, определенных в перечислении ValidationSummaryDisplayMode.
Значение
Отображение
BulletList
Каждое сообщение об ошибке выводится как маркированный элемент (по умолчанию).
List
Каждое сообщение об ошибке выводится в отдельной строке.
SingleParagraph
Каждое сообщение об ошибке выводится как предложение в абзаце.
Если отдельные проверяющие элементы управления сопоставляются с группами проверки, необходимо использовать один элемент управления ValidationSummary для каждой группы проверки.
Для отображения встроенных сообщений об ошибках и сообщений в сводке необходимо задать другие сочетания свойств в отдельных проверяющих элементах управления.
Отображение встроенных сообщений об ошибках и сводки сообщений
Добавьте элемент управления ValidationSummary, как было описано в предыдущей процедуре.
Установите свойства ErrorMessage, Text и Display отдельных проверяющих элементов управления в соответствии со следующей таблицей.
Параметр
Требуется элемент управления ValidationSummary.
Параметры свойств для проверяющего элемента управления
Только встроенный
Нет
Display = Static или Dynamic
ErrorMessage = <текст сообщения об ошибке> или Text = <текст сообщения об ошибке>
Только сводка (включая необязательное окно сообщений)
Да
Display = None
ErrorMessage = <текст сообщения об ошибке> или Text = <текст сообщения об ошибке>
Встроенный и в сводке (включая необязательное окно сообщений)
Да
Display = Static или Dynamic
ErrorMessage = <текст сообщения об ошибках для сводки>
Text = <встроенный текст сообщения об ошибках или глиф>
Если клиент использует обозреватель, поддерживающий DHTML, сводка сообщений об ошибках также выводится в окне сообщений.
Отображение сводки сообщений об ошибках в окне сообщений
Задайте для свойства ShowMessageBox элемента управления ValidationSummary значение true.
При отправке страницы ошибки отображаются как в элементе управления ValidationSummary, так и в окне сообщений.
Чтобы отобразить сводку сообщений об ошибках только в окне сообщений, задайте для свойства ShowSummary значение false.
См. также
Задачи
Практическое руководство. Определение размещения сообщений в серверных элементах управления ASP.NET
Ссылки
Проверка сведений, вводимых пользователем на веб-страницах ASP.NET