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 da entrada do usuário deve parar 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 uma MaskedTextBox única operação de entrada, normalmente copiando e colando uma cadeia de caracteres. Se a cadeia de caracteres inteira contiver apenas caracteres válidos, de acordo com a posição de colagem na máscara de entrada, toda a operação será bem-sucedida. No entanto, quando ocorre um erro de análise, o comportamento depende MaskedTextBox do valor de , da RejectInputOnFirstFailureseguinte 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 SkipLiterals as ResetOnSpace propriedades também podem influenciar a interpretação da entrada do usuário.
Se a IsOverwriteMode propriedade estiver false, todos os 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.
