Compartilhar via


Visão geral do componente ErrorProvider (Windows Forms)

O componente ErrorProvider do Windows Forms é usado para validar a entrada do usuário em um formulário ou controle. Normalmente, ele é usado em conjunto com a validação da entrada do usuário em um formulário ou a exibição de erros em um conjunto de dados. Um provedor de erros é uma alternativa melhor do que exibir uma mensagem de erro em uma caixa de mensagem, pois uma vez que uma caixa de mensagem é ignorada, a mensagem de erro não fica mais visível. O componente ErrorProvider exibe um ícone de erro (Um ponto de exclamação em branco dentro de um círculo vermelho.) ao lado do controle relevante, como uma caixa de texto; quando o usuário posiciona o ponteiro do mouse sobre o ícone de erro, uma Dica de Ferramenta é exibida, mostrando a cadeia de caracteres de mensagem de erro.

Propriedades Principais

As propriedades principais do componente ErrorProvider são DataSource, ContainerControle Icon. Ao usar ErrorProvider componente com controles associados a dados, a propriedade ContainerControl deve ser definida como o contêiner apropriado (geralmente o Formulário do Windows) para que o componente exiba um ícone de erro no formulário. Quando o componente é adicionado ao designer, a propriedade ContainerControl é definida como o formulário contentor; se você adicionar o controle no código, precisará defini-lo por conta própria.

A propriedade Icon pode ser definida como um ícone de erro personalizado em vez do padrão. Quando a propriedade DataSource é definida, o componente ErrorProvider pode exibir mensagens de erro para um conjunto de dados. O método chave do componente ErrorProvider é o método SetError, que especifica a cadeia de caracteres de mensagem de erro e onde o ícone de erro deve aparecer.

Observação

O componente ErrorProvider não fornece suporte interno para clientes de acessibilidade. Para tornar seu aplicativo acessível ao usar esse componente, você deve fornecer um mecanismo de comentários adicional e acessível.

Consulte também