MaskedTextBox.RejectInputOnFirstFailure Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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, setPublic Property RejectInputOnFirstFailure As BooleanValor 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 .
