Compartilhar via


MaskedTextBox.RejectInputOnFirstFailure Propriedade

Definição

Obtém ou define um valor que indica se a análise de entrada do usuário será interrompida depois que o primeiro caractere inválido for atingido.

public:
 property bool RejectInputOnFirstFailure { bool get(); void set(bool value); };
public bool RejectInputOnFirstFailure { get; set; }
member this.RejectInputOnFirstFailure : bool with get, set
Public Property RejectInputOnFirstFailure As Boolean

Valor da propriedade

true se o processamento da cadeia de caracteres de entrada deve ser encerrado no primeiro erro de análise; caso contrário, false se o processamento deve ignorar todos os erros. O padrão é false.

Comentários

Às vezes, o usuário insere vários caracteres em um MaskedTextBox em uma única operação de entrada, normalmente copiando e colando uma cadeia de caracteres. Se toda a cadeia de caracteres contiver apenas caracteres válidos, de acordo com a posição de colagem na máscara de entrada, toda a operação terá êxito. No entanto, quando ocorre um erro de análise, o comportamento de MaskedTextBox depende do valor de RejectInputOnFirstFailure, da seguinte maneira:

  • Se essa propriedade for true, o processamento da cadeia de caracteres de entrada será interrompido no caractere inválido. Todos os caracteres subsequentes são ignorados. Um único MaskInputRejected evento é gerado.

  • Se essa propriedade for false, o caractere inválido será rejeitado, mas a análise continuará com o próximo caractere na cadeia de caracteres de entrada. Um MaskInputRejected evento é gerado para cada caractere inválido na cadeia de caracteres de entrada.

As ResetOnPromptpropriedades e SkipLiteralsResetOnSpace também podem influenciar a interpretação da entrada do usuário.

Se a propriedade for false, todos os IsOverwriteMode caracteres já na máscara de entrada à direita do ponto de inserção serão deslocados pelo número aceito de caracteres. Essa mudança pode causar erros de análise adicionais.

Uma operação de colagem pode ser imitada programaticamente definindo a SelectedText propriedade .

Aplica-se a

Confira também