MaskedTextBox.RejectInputOnFirstFailure Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

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, set
Public Property RejectInputOnFirstFailure As Boolean

Valor de propiedad

Boolean

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 .

Se aplica a

Consulte también