Читать далее: Резюме

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

Метод SetError компонента ErrorProvider позволяет вывести сообщение об ошибке рядом с элементом управления. Этот метод принимает имя элемента управления и текст сообщения об ошибке в качестве параметров; вызывают его так:

Visual Basic .NET

' Этот пример предполагает наличие элемента управления nameTextBox
' и компонента ErrorProvider с именем myErrorProvider.
myErrorProvider.SetError(nameTextBox, "Name cannot be left blank!")

Visual C#

// Предполагается существование элемента управления nameTextBox
// и компонента ErrorProvider с именем myErrorProvider.
myErrorProvider.SetError(nameTextBox, "Name cannot be left blank!");

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

Сообщение об ошибке разрешается задавать и во время проектирования. Если изучить окно Properties после добавления на форму компонента ErrorProvider, нетрудно заметить, что у каждого элемента управления появилось новое свойство Error on x, где x — имя экземпляра ErrorProvider. Во время проектирования значение этого свойства задают через окно Properties, во время выполнения заданное таким образом значение отображается как сообщение об ошибке для данного элемента.

Ряд свойств компонента ErrorProvider определяет способ отображения сообщения об ошибке. Свойство Icon задает значок, отображаемый после элемента управления. Одна форма может содержать несколько экземпляров ErrorProvider, например один, отображающий сообщения об ошибках, а другой — предупреждения, при этом каждому экземпляру ErrorProvider разрешается назначить собственный значок. Другое свойство этого компонента — BlinkStyle — заставляет значок мигать, частоту мигания определяет свойство BlinkRate.

Применение компонента ErrorProvider при создании обработчика события, проверяющего значение элемента управления

1. Создайте форму и добавьте к ней компонент ErrorProvider — он появится в области компонентов.
2. Установите в true свойство CausesValidation элемента управления, который должен выводить сообщения об ошибках, если это еще не сделано.
3. Добавьте к обработчику события Validating этого элемента управления код, проверяющий введенное в него значение. При помощи метода SetError установите текст сообщения, которое отображается, если при проверке введенного обнаружится ошибка. Вот пример обработчика, использующего экземпляр компонента ErrorProvider с именем myErrorProvider; этот обработчик проверяет текстовое поле pswordTextBox:

Visual Basic .NET

Private Sub pswordTextBox_Validating(ByVal sender As Object, ByVal e As System.ComponentModel.CancelEventArgs) Handles pswordTextBox.Validating
  ' Проверить введенное значение.
  If pswordTextBox.Text = "" Then
    ' Задать текст сообщения об ошибке ввода.
    myErrorProvider.SetError(pswordTextBox, "Password cannot be blank!")
  Else
    ' Если введено допустимое значение, очистить текст сообщения:
    ' поскольку ошибки нет, сообщение не выводится.
    myErrorProvider.SetError(pswordTextBox, "")
  End If
End Sub

Visual C#

private void pswordTextBox_Validating(object sender, System.ComponentModel.CancelEventArgs e)
{
  // Проверить введенное значение.
  if (pswordTextBox.Text == "")
  {
    // Задать текст сообщения об ошибке ввода.
    myErrorProvider.SetError(pswordTextBox, "Password cannot be blank!");
  }
  else
  {
      // Если введено допустимое значение, очистить текст сообщения:
      // поскольку ошибки нет, сообщение не выводится.
    myErrorProvider.SetError(pswordTextBox, "");
  }
}