Como: Exibir ícones de erro de validação de formulário com o componente do Windows Forms ErrorProvider

Você pode usar Windows Forms ErrorProvider o componente para exibir um ícone de erro quando o usuário insere dados inválidos. Você deve ter pelo menos dois controles no formulário para guia entre eles e, portanto, chamar o código de validação.

Para exibir um ícone de erro quando o valor do controle é inválido

  1. Adicione dois controles — por exemplo, as caixas de texto — a um formulário do Windows.

  2. Adicionar um ErrorProvider o componente para o formulário.

  3. Selecione o primeiro controle e adicione código para seu Validating manipulador de eventos. Em ordem para que este código seja executado corretamente, o procedimento deve estar conectado ao evento. Para obter mais informações, consulte Como: Criar manipuladores de eventos em tempo de execução para Windows Forms.

    O código a seguir testa a validade dos dados que o usuário inseriu; Se os dados são inválidos, o SetError método é chamado. O primeiro argumento da SetError método Especifica que o controle para exibir o ícone ao lado. O segundo argumento é o texto de erro será exibido.

    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.");
       }
    }
    
    protected void textBox1_Validating(Object sender, CancelEventArgs e) 
    {
       try 
       {
          int x = Int32.Parse(textBox1.get_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++) Coloque o seguinte código no construtor do formulário para registrar o manipulador de eventos.

    this.textBox1.Validating += new
    System.ComponentModel.CancelEventHandler(this.textBox1_Validating);
    
    this->textBox1->Validating += gcnew
       System::ComponentModel::CancelEventHandler
       (this, &Form1::textBox1_Validating);
    
  4. Execute o projeto. Digite os dados inválidos (no exemplo, não-numéricos) no primeiro controle e o guia para a segunda. Quando o ícone de erro é exibido, aponte para ele, com o ponteiro do mouse para ver o texto de erro.

Consulte também

Tarefas

Como: Exibir erros dentro de um DataSet com o componente do Windows Forms ErrorProvider

Referência

SetError

Visão geral do ErrorProvider Component (Windows Forms)