MaskedTextBox.RejectInputOnFirstFailure Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define um valor que indica se a análise da entrada do utilizador deve parar após o primeiro carácter inválido ser 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 de Propriedade
true se o processamento da cadeia de entrada deve ser terminado no primeiro erro de análise sintática; caso contrário, false o processamento deverá ignorar todos os erros. A predefinição é false.
Observações
Por vezes, o utilizador insere vários caracteres MaskedTextBox numa única operação de entrada, normalmente copiando e colando uma cadeia. Se toda a cadeia contiver apenas caracteres válidos, de acordo com a sua posição de pasta na máscara de entrada, então toda a operação terá sucesso. No entanto, quando ocorre um erro de análise sintática, o comportamento de MaskedTextBox depende do valor de RejectInputOnFirstFailure, da seguinte forma:
Se esta propriedade for
true, então o processamento da cadeia de entrada para no carácter inválido. Todas as personagens subsequentes são ignoradas. É levantado um único MaskInputRejected evento.Se esta propriedade for
false, então o carácter inválido é rejeitado, mas a análise continua com o próximo carácter na cadeia de entrada. Um MaskInputRejected evento é gerado para cada carácter inválido na cadeia de entrada.
As ResetOnPromptpropriedades , ResetOnSpace e SkipLiterals também podem influenciar a interpretação da entrada do utilizador.
Se a IsOverwriteMode propriedade for false, então quaisquer caracteres já presentes na máscara de entrada à direita do ponto de inserção serão deslocados pelo número aceite. Este deslocamento pode causar erros adicionais de análise sintática.
Uma operação de colagem pode ser imitada programaticamente ao definir a propriedade SelectedText .