MaskedTextProvider Clase

Definición

Espacio de nombres:

System.ComponentModel

Ensamblados:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Source:

MaskedTextProvider.cs

Representa un servicio de análisis de máscaras que puede usar cualquier número de controles que admiten el enmascaramiento, como el MaskedTextBox control .

public ref class MaskedTextProvider : ICloneable

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicConstructors)]
public class MaskedTextProvider : ICloneable

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicConstructors)>]
type MaskedTextProvider = class
    interface ICloneable

Public Class MaskedTextProvider
Implements ICloneable

Herencia

Object

MaskedTextProvider

Atributos

DynamicallyAccessedMembersAttribute

Implementaciones

ICloneable

Comentarios

El MaskedTextBox control contiene una máscara, compuesta de caracteres literales y elementos de formato, en las que se prueban todas las entradas del usuario. En lugar de asociar permanentemente un motor de análisis de máscaras específico con MaskedTextBox, Windows Forms lo proporciona como un servicio independiente, representado por la MaskedTextProvider clase , que define la sintaxis del lenguaje de enmascaramiento descrito en la documentación de la Mask propiedad .

Muchos de los miembros de la MaskedTextBox clase hacen referencia a su implementación a miembros con nombre similares del asociado MaskedTextProvider. Por ejemplo, la MaskedTextBox.PromptChar propiedad de la MaskedTextBox clase hace referencia a todo el PromptChar acceso a de la MaskedTextProvider clase .

El motor de análisis de máscaras utilizado por MaskedTextProvider se modela después del control Edición enmascarada incluido en la versión 6 de Microsoft Visual Basic. Su lenguaje de enmascaramiento se describe en la documentación de la Mask propiedad .

Las tres cadenas distintas siguientes están implicadas en la MaskedTextProvider clase .

Nombre de cadena	Descripción
Carácter o cadena de entrada	Representa los caracteres usados como entrada en los que se aplica la máscara. En realidad, la cadena de entrada puede estar compuesta de varias operaciones de entrada, como Add, Replace, InsertAty Remove. Por lo tanto, no se puede acceder directamente a la cadena de entrada. Sin embargo, los aspectos del control de cadenas de entrada están disponibles aunque las AllowPromptAsInput propiedades y AsciiOnly, ResetOnPrompty ResetOnSpace .
Máscara	Representa la máscara de formato de entrada usada para transformar la cadena de entrada en la cadena con formato. Esta cadena se establece en MaskedTextProvider y se obtiene acceso principalmente a la Mask propiedad . Las características de la máscara también están disponibles a través de otros miembros, como las Lengthpropiedades , PasswordChary PromptChar .
Cadena con formato	Representa la cadena que da como resultado cuando se aplica la máscara completa a la cadena de entrada. La cadena con formato se puede consultar con muchos miembros de la clase, incluidos Item[], Length, LastAssignedPosition, MaskFull, MaskCompleted, FindEditPositionFrom, etc. El valor completo de la cadena con formato está disponible en los ToDisplayString métodos y ToString .

Nota:

La cadena de entrada puede representar la entrada directa del usuario, como en el caso de , o puede generarse por otros procesos no asociados directamente con las operaciones de entrada y salida del MaskedTextBoxusuario.

Constructores

Nombre	Description
MaskedTextProvider(String, Boolean)	Inicializa una nueva instancia de la MaskedTextProvider clase utilizando la máscara y el valor de restricción ASCII especificados.
MaskedTextProvider(String, Char, Boolean)	Inicializa una nueva instancia de la MaskedTextProvider clase utilizando la máscara, el carácter de contraseña y el valor de uso del símbolo del sistema especificados.
MaskedTextProvider(String, CultureInfo, Boolean, Char, Char, Boolean)	Inicializa una nueva instancia de la MaskedTextProvider clase mediante la máscara, la referencia cultural, el valor de uso del símbolo del sistema, el carácter de aviso, el carácter de contraseña y el valor de restricción ASCII especificados.
MaskedTextProvider(String, CultureInfo, Boolean)	Inicializa una nueva instancia de la MaskedTextProvider clase utilizando el valor de restricción ASCII, referencia cultural y máscara especificados.
MaskedTextProvider(String, CultureInfo, Char, Boolean)	Inicializa una nueva instancia de la MaskedTextProvider clase utilizando la máscara, la referencia cultural, el carácter de contraseña y el valor de uso del símbolo del sistema especificados.
MaskedTextProvider(String, CultureInfo)	Inicializa una nueva instancia de la MaskedTextProvider clase utilizando la máscara y la referencia cultural especificadas.
MaskedTextProvider(String)	Inicializa una nueva instancia de la MaskedTextProvider clase utilizando la máscara especificada.

Propiedades

Nombre	Description
AllowPromptAsInput	Obtiene un valor que indica si el carácter del símbolo del sistema debe tratarse como un carácter de entrada válido o no.
AsciiOnly	Obtiene un valor que indica si la máscara acepta caracteres fuera del juego de caracteres ASCII.
AssignedEditPositionCount	Obtiene el número de posiciones de caracteres editables que ya se han asignado correctamente a un valor de entrada.
AvailableEditPositionCount	Obtiene el número de posiciones de caracteres editables en la máscara de entrada que aún no se les ha asignado un valor de entrada.
Culture	Obtiene la referencia cultural que determina el valor de los separadores y marcadores de posición localizables en la máscara de entrada.
DefaultPasswordChar	Obtiene el carácter de contraseña predeterminado usado para ocultar la entrada del usuario.
EditPositionCount	Obtiene el número de posiciones editables en la cadena con formato.
EditPositions	Obtiene un enumerador recién creado para las posiciones editables en la cadena con formato.
IncludeLiterals	Obtiene o establece un valor que indica si los caracteres literales de la máscara de entrada deben incluirse en la cadena con formato.
IncludePrompt	Obtiene o establece un valor que indica si PromptChar se usa para representar la ausencia de entrada del usuario al mostrar la cadena con formato.
InvalidIndex	Obtiene el límite superior del intervalo de índices no válidos.
IsPassword	Obtiene o establece un valor que determina si se debe aplicar protección con contraseña a la cadena con formato.
Item[Int32]	Obtiene el elemento en la posición especificada en la cadena con formato.
LastAssignedPosition	Obtiene el índice de la máscara del carácter de entrada más a la derecha que se ha asignado a la máscara.
Length	Obtiene la longitud de la máscara, ausente cualquier carácter modificador de máscara.
Mask	Obtiene la máscara de entrada.
MaskCompleted	Obtiene un valor que indica si se han escrito todas las entradas necesarias en la cadena con formato.
MaskFull	Obtiene un valor que indica si todas las entradas obligatorias y opcionales se han escrito en la cadena con formato.
PasswordChar	Obtiene o establece el carácter que se va a sustituir por los caracteres de entrada reales.
PromptChar	Obtiene o establece el carácter usado para representar la ausencia de entrada del usuario para todas las posiciones de edición disponibles.
ResetOnPrompt	Obtiene o establece un valor que determina cómo debe controlarse un carácter de entrada que coincida con el carácter de solicitud.
ResetOnSpace	Obtiene o establece un valor que determina cómo se debe controlar un carácter de entrada de espacio.
SkipLiterals	Obtiene o establece un valor que indica si sus mismos valores pueden sobrescribir las posiciones de caracteres literales de la máscara.

Métodos

Nombre	Description
Add(Char, Int32, MaskedTextResultHint)	Agrega el carácter de entrada especificado al final de la cadena con formato y, a continuación, genera información de posición y descriptiva.
Add(Char)	Agrega el carácter de entrada especificado al final de la cadena con formato.
Add(String, Int32, MaskedTextResultHint)	Agrega los caracteres de la cadena de entrada especificada al final de la cadena con formato y, a continuación, genera información de posición y descriptiva.
Add(String)	Agrega los caracteres de la cadena de entrada especificada al final de la cadena con formato.
Clear()	Borra todos los caracteres de entrada editables de la cadena con formato y los reemplaza por caracteres de aviso.
Clear(MaskedTextResultHint)	Borra todos los caracteres de entrada editables de la cadena con formato, los reemplaza por caracteres de aviso y, a continuación, genera información descriptiva.
Clone()	Crea una copia del objeto actual MaskedTextProvider.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
FindAssignedEditPositionFrom(Int32, Boolean)	Devuelve la posición de la primera posición editable asignada después de la posición especificada mediante la dirección de búsqueda especificada.
FindAssignedEditPositionInRange(Int32, Int32, Boolean)	Devuelve la posición de la primera posición editable asignada entre las posiciones especificadas mediante la dirección de búsqueda especificada.
FindEditPositionFrom(Int32, Boolean)	Devuelve la posición de la primera posición editable después de la posición especificada mediante la dirección de búsqueda especificada.
FindEditPositionInRange(Int32, Int32, Boolean)	Devuelve la posición de la primera posición editable entre las posiciones especificadas mediante la dirección de búsqueda especificada.
FindNonEditPositionFrom(Int32, Boolean)	Devuelve la posición de la primera posición no editable después de la posición especificada mediante la dirección de búsqueda especificada.
FindNonEditPositionInRange(Int32, Int32, Boolean)	Devuelve la posición de la primera posición no editable entre las posiciones especificadas mediante la dirección de búsqueda especificada.
FindUnassignedEditPositionFrom(Int32, Boolean)	Devuelve la posición de la primera posición editable sin asignar después de la posición especificada mediante la dirección de búsqueda especificada.
FindUnassignedEditPositionInRange(Int32, Int32, Boolean)	Devuelve la posición de la primera posición editable sin asignar entre las posiciones especificadas mediante la dirección de búsqueda especificada.
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetOperationResultFromHint(MaskedTextResultHint)	Determina si el especificado MaskedTextResultHint indica éxito o error.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InsertAt(Char, Int32, Int32, MaskedTextResultHint)	Inserta el carácter especificado en la posición especificada dentro de la cadena con formato, devolviendo la última posición de inserción y el estado de la operación.
InsertAt(Char, Int32)	Inserta el carácter especificado en la posición especificada dentro de la cadena con formato.
InsertAt(String, Int32, Int32, MaskedTextResultHint)	Inserta la cadena especificada en una posición especificada dentro de la cadena con formato, devolviendo la última posición de inserción y el estado de la operación.
InsertAt(String, Int32)	Inserta la cadena especificada en una posición especificada dentro de la cadena con formato.
IsAvailablePosition(Int32)	Determina si la posición especificada está disponible para la asignación.
IsEditPosition(Int32)	Determina si la posición especificada se puede editar.
IsValidInputChar(Char)	Determina si el carácter especificado es un carácter de entrada válido.
IsValidMaskChar(Char)	Determina si el carácter especificado es un carácter de máscara válido.
IsValidPasswordChar(Char)	Determina si el carácter especificado es un carácter de contraseña válido.
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
Remove()	Quita el último carácter asignado de la cadena con formato.
Remove(Int32, MaskedTextResultHint)	Quita el último carácter asignado de la cadena con formato y, a continuación, genera la posición de eliminación y la información descriptiva.
RemoveAt(Int32, Int32, Int32, MaskedTextResultHint)	Quita los caracteres asignados entre las posiciones especificadas de la cadena con formato y, a continuación, genera la posición de eliminación y la información descriptiva.
RemoveAt(Int32, Int32)	Quita los caracteres asignados entre las posiciones especificadas de la cadena con formato.
RemoveAt(Int32)	Quita el carácter asignado en la posición especificada de la cadena con formato.
Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)	Reemplaza un carácter único entre las posiciones inicial y final especificadas por el valor de carácter especificado y, a continuación, genera la posición de eliminación y la información descriptiva.
Replace(Char, Int32, Int32, MaskedTextResultHint)	Reemplaza un carácter único en o más allá de la posición especificada por el valor de carácter especificado y, a continuación, genera la posición de eliminación y la información descriptiva.
Replace(Char, Int32)	Reemplaza un carácter único en o más allá de la posición especificada por el valor de carácter especificado.
Replace(String, Int32, Int32, Int32, MaskedTextResultHint)	Reemplaza un intervalo de caracteres editables entre las posiciones inicial y final especificadas por la cadena especificada y, a continuación, genera la posición de eliminación y la información descriptiva.
Replace(String, Int32, Int32, MaskedTextResultHint)	Reemplaza un intervalo de caracteres editables a partir de la posición especificada por la cadena especificada y, a continuación, genera la posición de eliminación y la información descriptiva.
Replace(String, Int32)	Reemplaza un intervalo de caracteres editables a partir de la posición especificada por la cadena especificada.
Set(String, Int32, MaskedTextResultHint)	Establece la cadena con formato en la cadena de entrada especificada y, a continuación, genera la posición de eliminación y la información descriptiva.
Set(String)	Establece la cadena con formato en la cadena de entrada especificada.
ToDisplayString()	Devuelve la cadena con formato en un formulario que se puede mostrar.
ToString()	Devuelve la cadena con formato que incluye todos los valores de caracteres asignados.
ToString(Boolean, Boolean, Boolean, Int32, Int32)	Devuelve una subcadena de la cadena con formato, que opcionalmente incluye caracteres prompt, literal y password.
ToString(Boolean, Boolean, Int32, Int32)	Devuelve una subcadena de la cadena con formato, que opcionalmente incluye caracteres literales y de solicitud.
ToString(Boolean, Boolean)	Devuelve la cadena con formato, que opcionalmente incluye caracteres de mensaje y literales.
ToString(Boolean, Int32, Int32)	Devuelve una subcadena de la cadena con formato, que opcionalmente incluye caracteres de contraseña.
ToString(Boolean)	Devuelve la cadena con formato, que opcionalmente incluye caracteres de contraseña.
ToString(Int32, Int32)	Devuelve una subcadena de la cadena con formato.
VerifyChar(Char, Int32, MaskedTextResultHint)	Comprueba si el carácter especificado podría establecerse correctamente en la posición especificada.
VerifyEscapeChar(Char, Int32)	Comprueba si el carácter especificado se escaparía en la posición especificada.
VerifyString(String, Int32, MaskedTextResultHint)	Comprueba si la cadena especificada se puede establecer correctamente y, a continuación, genera información de posición y descriptiva.
VerifyString(String)	Comprueba si la cadena especificada podría establecerse correctamente.

Consulte también

• MaskedTextBox
• MaskedTextProvider
• Mask