Практическое руководство. Отображение значков ошибок при проверке введенных в форму данных с помощью компонента ErrorProvider в Windows Forms

  • Статья

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

Отображение значка ошибки при недопустимом значении элемента управления

  1. Добавьте два элемента управления (например, текстовые поля) в форму Windows Forms.

  2. Добавьте в форму компонент ErrorProvider.

  3. Выберите первый элемент управления и добавьте код в обработчик событий Validating. Чтобы этот код выполнялся правильно, процедура должна быть подключена к событию. Дополнительные сведения см. в разделе Практическое руководство. Создание обработчиков событий для Windows Forms во время выполнения.

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

    Private Sub TextBox1_Validating(ByVal Sender As Object, _  
   ByVal e As System.ComponentModel.CancelEventArgs) Handles _  
   TextBox1.Validating  
      If Not IsNumeric(TextBox1.Text) Then  
         ErrorProvider1.SetError(TextBox1, "Not a numeric value.")  
      Else  
         ' Clear the error.  
         ErrorProvider1.SetError(TextBox1, "")  
      End If  
End Sub  

    protected void textBox1_Validating (object sender,  
   System.ComponentModel.CancelEventArgs e)  
{  
   try  
   {  
      int x = Int32.Parse(textBox1.Text);  
      errorProvider1.SetError(textBox1, "");  
   }  
   catch (Exception ex)  
   {  
      errorProvider1.SetError(textBox1, "Not an integer value.");  
   }  
}  

    private:  
   System::Void textBox1_Validating(System::Object ^  sender,  
      System::ComponentModel::CancelEventArgs ^  e)  
   {  
      try  
      {  
         int x = Int32::Parse(textBox1->Text);  
         errorProvider1->SetError(textBox1, "");  
      }  
      catch (System::Exception ^ ex)  
      {  
         errorProvider1->SetError(textBox1, "Not an integer value.");  
      }  
   }

    (Visual C#, Visual C++) Поместите следующий код в конструктор формы для регистрации обработчика событий.

    this.textBox1.Validating += new  
System.ComponentModel.CancelEventHandler(this.textBox1_Validating);  

    this->textBox1->Validating += gcnew  
   System::ComponentModel::CancelEventHandler  
   (this, &Form1::textBox1_Validating);

  4. Запустите проект. Введите недопустимые (в этом примере нечисловые) данные в первый элемент управления, а затем перейдите ко второму элементу управления. Когда отображается значок ошибки, наведите на него указатель мыши, чтобы увидеть текст ошибки.

См. также