Controles invisível: Usando componentes

Há vários componentes que você pode usar em aplicativos Windows Forms para ajudar você a executar uma tarefa específica.Por exemplo, você pode usar um componente ErrorProvider para ajudar a validar dados inseridos em um controle Windows Forms.Os componentes estão disponíveis na Toolbox e você pode arrastá-los para um Windows Form da mesma forma que você arrasta os controles.No entanto, a principal diferença entre os controles e componentes é que os componentes geralmente não têm uma interface do usuário, e você não pode vê-los no formulário.

Quando você arrasta um componente a um formulário, ele é adicionado para a bandeja de componentes, uma área na parte inferior do modo de exibição Design.Muitos dos componentes disponíveis estão listados na guia Components da Toolbox.Você encontrará os componentes adicionais nas outras guias, como a guia Dialogs, a guia Data e a guia Menus & Toolbars.

Nesta lição, você adicionará alguns controles TextBox a um Windows Form.Em seguida, você usará um componente ErrorProvider para ajudar a validar os dados inseridos em uma das caixas de texto.Você pode escrever o código no manipulador de eventos Validating de um controle, como um TextBox, para garantir que os dados de um usuário digitados são válidos.Se os dados não forem válidos, um ícone de erro aparece próximo ao controle.Os usuários podem exibir o erro ao posicionar o ponteiro do mouse no ícone de erro.

Tente-o!

Para validar dados usando um componente ErrorProvider

1. On the Arquivo menu, clicar Novo projeto.

   A caixa de diálogo New Project será exibida.

2. Clique em Windows Forms Application e em seguida, clique em OK .

   Abre um novo projeto Windows Forms.

3. Adicionar um Rótulo controle ao formulário, deixando o nome padrão Label1 e, em seguida, alterar o Texto propriedade do controle para nome.

4. Adicionar um TextBox controle ao lado de Rótulo controle, deixando o nome padrão TextBox1.

5. Adicionar outro Rótulo controle ao formulário, deixando o padrão nome Label2 e, em seguida, altere o Texto propriedade do controle para a idade.

6. Adicionar um TextBox controle próximo a esse Rótulo controle, deixando o nome padrão TextBox2.

7. arrastar um ErrorProvider o componenteComponentes Guia de do Caixa de ferramentas para o formulário, deixando o nome padrão ErrorProvider1.

   O componente é adicionado à bandeja de componentes.

8. Abra o Editor de Código clicando com o botão direito do mouse no formulário e clicando em View Code.

9. No Editor de Código, na lista suspensa Class Name, clique em TextBox2.

10. Na lista suspensa Method Name, clique em Validating para criar o manipulador de eventos.

11. Adicione o seguinte código para o manipulador de eventos TextBox2_Validating.Esse código verifica se os dados inseridos em TextBox2 são um valor numérico.Se não for, o código define a mensagem de erro para o componente ErrorProvider.

    If Not IsNumeric(TextBox2.Text) Then
        ErrorProvider1.SetError(TextBox2, _
            "You must enter a numeric value.")
    Else
        ErrorProvider1.SetError(TextBox2, "")
    End If
    

12. Pressione F5 para executar a página.

13. Quando o formulário for exibido, digite seu nome na primeira caixa de texto, digite sua cor favorita na segunda caixa de texto e em seguida, pressione a tecla TAB.

    Um ícone de erro é exibido próximo a TextBox2.

14. Coloque o ponteiro do mouse sobre o ícone de erro para exibir o texto de erro.

15. Digite a sua idade, usando números, na caixa de texto e pressione a tecla TAB.

    O ícone de erro desaparece.

Próximas etapas

Nesta lição, você aprendeu como adicionar um componente que permite que você valide os dados para um programa.

Na próxima lição, você aprenderá a usar algumas das caixas de diálogo internas em seus programas.

Próxima Lesson: Reutilização de controles: Trabalhando com caixas de diálogo interna

Consulte também

Referência

ErrorProvider componente Overview (Windows Forms)

Outros recursos

Criando a aparência do seu programa Visual: Introdução ao Windows Forms