MaskedTextBox.RejectInputOnFirstFailure Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece un valor que indica si el análisis de los datos proporcionados por el usuario debe detenerse al llegar al primer carácter no válido.
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 propiedad
Es true si el procesamiento de la cadena de entrada debe finalizar en el primer error de análisis; de lo contrario, es false si al procesar, se deberían omitir todos los errores. De manera predeterminada, es false.
Comentarios
A veces, el usuario escribirá varios caracteres en una MaskedTextBox operación de entrada única, normalmente copiando y pegando una cadena. Si toda la cadena solo contiene caracteres válidos, según su posición de pegado en la máscara de entrada, toda la operación se realizará correctamente. Sin embargo, cuando se produce un error de análisis, el comportamiento de MaskedTextBox depende del valor de RejectInputOnFirstFailure, como se indica a continuación:
Si esta propiedad es
true, el procesamiento de la cadena de entrada se detiene en el carácter no válido. Se omiten todos los caracteres posteriores. Se genera un único MaskInputRejected evento.Si esta propiedad es
false, se rechaza el carácter no válido, pero el análisis continúa con el siguiente carácter de la cadena de entrada. Se genera un MaskInputRejected evento para cada carácter no válido de la cadena de entrada.
Las ResetOnPromptpropiedades , ResetOnSpace y SkipLiterals también pueden influir en la interpretación de la entrada del usuario.
Si la IsOverwriteMode propiedad es false, los caracteres que ya estén en la máscara de entrada a la derecha del punto de inserción se desplazarán por el número aceptado de caracteres. Este cambio puede provocar errores de análisis adicionales.
Una operación de pegado se puede imitar mediante programación estableciendo la SelectedText propiedad .
