Практическое руководство. Управление отображением сообщений об ошибках проверки для серверных элементов управления ASP.NET

Visual Studio 2010

Обновлен: Ноябрь 2007

В Microsoft Visual Web Developer можно отобразить текст сообщения об ошибке четырьмя различными способами, описанными в следующей таблице.

Метод отображения

Описание

Встроенный

Сообщение об ошибке отображается рядом с элементом управления, в месте расположения проверяющего элемента управления.

Сводка

Сообщение об ошибке отображается в отдельной сводке всех ошибок, которая доступна, только когда пользователь отправляет страницу. Кроме того, сообщение об ошибке может отображаться в окне сообщения, но данный параметр доступен только в обозревателях, поддерживающих динамический HTML (DHTML).

Встроенный и в сводке

Сообщение об ошибках в сводке может отличаться от встроенного. Этот параметр служит для отображения более короткого встроенного сообщения об ошибках и более подробного — в сводке, а также для отображения глифа ошибки в сводке рядом с полем ввода и сообщением об ошибках в сводке.

Пользовательское

Можно создать собственное отображение сообщений об ошибках. Дополнительные сведения см. в разделе Практическое руководство. Отображение настраиваемых сообщений о проверке на стороне сервера для серверных элементов управления ASP.NET.

Чтобы отобразить сводку сообщений об ошибках, необходимо добавить на страницу элемент управления.

Отображение сводки сообщений об ошибках

  1. Добавьте на страницу элемент управления ValidationSummary в расположение, в котором должны отображаться собранные сообщения об ошибках.

  2. Задайте свойства ErrorMessage и Display отдельных проверяющих элементов управления.

  3. Задайте для свойства DisplayMode элемента управления сводкой форматирование сообщений об ошибках с помощью одного из следующих значений, определенных в перечислении ValidationSummaryDisplayMode.

    Значение

    Отображение

    BulletList

    Каждое сообщение об ошибке выводится как маркированный элемент (по умолчанию).

    List

    Каждое сообщение об ошибке выводится в отдельной строке.

    SingleParagraph

    Каждое сообщение об ошибке выводится как предложение в абзаце.

  4. Если отдельные проверяющие элементы управления сопоставляются с группами проверки, необходимо использовать один элемент управления ValidationSummary для каждой группы проверки.

Для отображения встроенных сообщений об ошибках и сообщений в сводке необходимо задать другие сочетания свойств в отдельных проверяющих элементах управления.

Отображение встроенных сообщений об ошибках и сводки сообщений

  1. Добавьте элемент управления ValidationSummary, как было описано в предыдущей процедуре.

  2. Установите свойства ErrorMessage, Text и Display отдельных проверяющих элементов управления в соответствии со следующей таблицей.

    Параметр

    Требуется элемент управления ValidationSummary.

    Параметры свойств для проверяющего элемента управления

    Только встроенный

    Нет

    Display = Static или Dynamic

    ErrorMessage = <текст сообщения об ошибке> или Text = <текст сообщения об ошибке>

    Только сводка (включая необязательное окно сообщений)

    Да

    Display = None

    ErrorMessage = <текст сообщения об ошибке> или Text = <текст сообщения об ошибке>

    Встроенный и в сводке (включая необязательное окно сообщений)

    Да

    Display = Static или Dynamic

    ErrorMessage = <текст сообщения об ошибках для сводки>

    Text = <встроенный текст сообщения об ошибках или глиф>

Если клиент использует обозреватель, поддерживающий DHTML, сводка сообщений об ошибках также выводится в окне сообщений.

Отображение сводки сообщений об ошибках в окне сообщений

  1. Задайте для свойства ShowMessageBox элемента управления ValidationSummary значение true.

    При отправке страницы ошибки отображаются как в элементе управления ValidationSummary, так и в окне сообщений.

  2. Чтобы отобразить сводку сообщений об ошибках только в окне сообщений, задайте для свойства ShowSummary значение false.

Показ: