Compartir a través de


MaskedTextProvider Clase

Definición

Representa un servicio de análisis de máscaras que cualquier control compatible con el uso de máscaras puede utilizar como, por ejemplo, MaskedTextBox.

public ref class MaskedTextProvider : ICloneable
public class MaskedTextProvider : ICloneable
type MaskedTextProvider = class
    interface ICloneable
Public Class MaskedTextProvider
Implements ICloneable
Herencia
MaskedTextProvider
Implementaciones

Comentarios

El MaskedTextBox control contiene una máscara, compuesta de caracteres literales y elementos de formato, con las que prueba 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 acceso a PromptChar de la MaskedTextProvider clase .

El motor de análisis de máscaras usado por MaskedTextProvider se modela después del control Edición enmascarada incluido en Microsoft Visual Basic versión 6. 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 la 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 se puede componer 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 a través de las AllowPromptAsInput propiedades y AsciiOnlyResetOnPrompt, y 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[], , LengthLastAssignedPosition, 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 ser generada por otros procesos no asociados directamente con las operaciones de entrada y salida del MaskedTextBoxusuario.

Constructores

MaskedTextProvider(String)

Inicializa una nueva instancia de la clase MaskedTextProvider con la máscara especificada.

MaskedTextProvider(String, Boolean)

Inicializa una nueva instancia de la clase MaskedTextProvider con la máscara y el valor de restricción ASCII especificados.

MaskedTextProvider(String, Char, Boolean)

Inicializa una nueva instancia de la clase MaskedTextProvider con la máscara, el carácter de contraseña y el valor de uso del carácter de petición de datos que se hayan especificado.

MaskedTextProvider(String, CultureInfo)

Inicializa una nueva instancia de la clase MaskedTextProvider con la máscara y referencia cultural especificadas.

MaskedTextProvider(String, CultureInfo, Boolean)

Inicializa una nueva instancia de la clase MaskedTextProvider con la máscara, la referencia cultural y el valor de restricción ASCII especificados.

MaskedTextProvider(String, CultureInfo, Boolean, Char, Char, Boolean)

Inicializa una nueva instancia de la clase MaskedTextProvider con la máscara, la referencia cultural, el valor de uso del carácter de petición de datos, el carácter de petición de datos, el carácter de contraseña y valor de restricción ASCII especificados.

MaskedTextProvider(String, CultureInfo, Char, Boolean)

Inicializa una nueva instancia de la clase MaskedTextProvider con la máscara, la referencia cultural, el carácter de contraseña y el valor de uso del carácter de petición de datos que se hayan especificado.

Propiedades

AllowPromptAsInput

Obtiene un valor que indica si el carácter de petición de datos debe considerarse como un carácter de entrada válido o no.

AsciiOnly

Obtiene un valor que indica si la máscara acepta caracteres que no pertenecen al juego de caracteres ASCII.

AssignedEditPositionCount

Obtiene el número de posiciones de caracteres modificables a las que ya se les ha asignado correctamente un valor de entrada.

AvailableEditPositionCount

Obtiene el número de posiciones de caracteres modificables de la máscara de entrada a las 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 de la máscara de entrada.

DefaultPasswordChar

Obtiene el carácter de contraseña predeterminado que se utiliza para ocultar los datos proporcionados por el usuario.

EditPositionCount

Obtiene el número de posiciones modificables de la cadena con formato.

EditPositions

Obtiene un enumerador recién creado para las posiciones modificables de 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 la propiedad PromptChar se utiliza para representar que el usuario no ha especificado ningún dato cuando se muestra la cadena con formato.

InvalidIndex

Obtiene el límite superior del intervalo de índices que no son 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 situado en la posición especificada de la cadena con formato.

LastAssignedPosition

Obtiene el índice de la máscara correspondiente al carácter de entrada situado más a la derecha que se haya asignado a la máscara.

Length

Obtiene la longitud de la máscara, sin ningún carácter modificador de máscara.

Mask

Obtiene la máscara de entrada.

MaskCompleted

Obtiene un valor que indica si se han especificado todas las entradas obligatorias en la cadena con formato.

MaskFull

Obtiene un valor que indica si se han especificado todas las entradas obligatorias y opcionales 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 que se utiliza para representar que el usuario no ha especificado ningún dato para todas las posiciones de edición disponibles.

ResetOnPrompt

Obtiene o establece un valor que determina la forma en que debe controlarse un carácter de entrada que coincida con el de petición de datos.

ResetOnSpace

Obtiene o establece un valor que determina la forma en que debe controlarse un carácter de entrada de espacio.

SkipLiterals

Obtiene o establece un valor que indica si las posiciones de caracteres literales de la máscara se pueden sobrescribir con sus mismos valores.

Métodos

Add(Char)

Agrega el carácter de entrada especificado al final de la cadena con formato.

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 sobre la posición e información descriptiva.

Add(String)

Agrega los caracteres de la cadena de entrada especificada 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 sobre la posición e información descriptiva.

Clear()

Borra todos los caracteres de entrada modificables de la cadena con formato, reemplazándolos por caracteres de petición de datos.

Clear(MaskedTextResultHint)

Borra todos los caracteres de entrada modificables de la cadena con formato, reemplazándolos por caracteres de petición de datos y, a continuación, genera información descriptiva.

Clone()

Crea una copia del objeto MaskedTextProvider actual.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
FindAssignedEditPositionFrom(Int32, Boolean)

Devuelve la posición de la primera posición modificable asignada que se encuentre después de la posición especificada utilizando la dirección de búsqueda indicada.

FindAssignedEditPositionInRange(Int32, Int32, Boolean)

Devuelve la posición de la primera posición modificable asignada que se encuentre entre las posiciones especificadas utilizando la dirección de búsqueda indicada.

FindEditPositionFrom(Int32, Boolean)

Devuelve la posición de la primera posición modificable situada después de la posición especificada utilizando la dirección de búsqueda indicada.

FindEditPositionInRange(Int32, Int32, Boolean)

Devuelve la posición de la primera posición modificable que se encuentre entre las posiciones especificadas utilizando la dirección de búsqueda indicada.

FindNonEditPositionFrom(Int32, Boolean)

Devuelve la posición de la primera posición no modificable situada después de la posición especificada utilizando la dirección de búsqueda indicada.

FindNonEditPositionInRange(Int32, Int32, Boolean)

Devuelve la posición de la primera posición no modificable que se encuentre entre las posiciones especificadas utilizando la dirección de búsqueda indicada.

FindUnassignedEditPositionFrom(Int32, Boolean)

Devuelve la posición de la primera posición modificable sin asignar situada después de la posición especificada utilizando la dirección de búsqueda indicada.

FindUnassignedEditPositionInRange(Int32, Int32, Boolean)

Devuelve la posición de la primera posición modificable sin asignar que se encuentre entre las posiciones especificadas utilizando la dirección de búsqueda indicada.

GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetOperationResultFromHint(MaskedTextResultHint)

Determina si la enumeración MaskedTextResultHint especificada denota éxito o error.

GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
InsertAt(Char, Int32)

Inserta el carácter especificado en la posición indicada de la cadena con formato.

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Inserta el carácter especificado en la posición indicada de la cadena con formato y devuelve la última posición de inserción y el estado de la operación.

InsertAt(String, Int32)

Inserta la cadena especificada en la posición indicada de la cadena con formato.

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Inserta la cadena especificada en la posición indicada de la cadena con formato y devuelve la última posición de inserción y el estado de la operación.

IsAvailablePosition(Int32)

Determina si la posición especificada está disponible para asignarse.

IsEditPosition(Int32)

Determina si la posición especificada es modificable.

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 Object actual.

(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 información sobre la posición de eliminación e información descriptiva.

RemoveAt(Int32)

Quita el carácter asignado de la posición especificada de la cadena con formato.

RemoveAt(Int32, Int32)

Quita los caracteres asignados situados entre las posiciones especificadas de la cadena con formato.

RemoveAt(Int32, Int32, Int32, MaskedTextResultHint)

Quita los caracteres asignados situados entre las posiciones especificadas de la cadena con formato y, a continuación, genera información sobre la posición de eliminación e información descriptiva.

Replace(Char, Int32)

Reemplaza un carácter individual por el valor de carácter especificado en la posición indicada o más allá de la misma.

Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)

Reemplaza un carácter individual situado entre las posiciones inicial y final especificadas por el valor de carácter especificado y, a continuación, genera información sobre la posición de eliminación e información descriptiva.

Replace(Char, Int32, Int32, MaskedTextResultHint)

Reemplaza un único carácter situado en la posición especificada o más allá de la misma por el valor de carácter especificado y, a continuación, genera información sobre la posición de eliminación e información descriptiva.

Replace(String, Int32)

Reemplaza un intervalo de caracteres modificables por la cadena especificada comenzando en la posición indicada.

Replace(String, Int32, Int32, Int32, MaskedTextResultHint)

Reemplaza un intervalo de caracteres modificables por la cadena especificada entre las posiciones inicial y final indicadas, y, a continuación, genera información sobre la posición de eliminación e información descriptiva.

Replace(String, Int32, Int32, MaskedTextResultHint)

Reemplaza un intervalo de caracteres modificables por la cadena especificada comenzando en la posición indicada y, a continuación, genera información sobre la posición de eliminación e información descriptiva.

Set(String)

Establece la cadena con formato en la cadena de entrada especificada.

Set(String, Int32, MaskedTextResultHint)

Establece la cadena con formato en la cadena de entrada especificada y, a continuación, genera información sobre la posición de eliminación e información descriptiva.

ToDisplayString()

Devuelve la cadena con formato en un formato que se pueda mostrar.

ToString()

Devuelve la cadena con formato que contiene todos los valores de caracteres asignados.

ToString(Boolean)

Devuelve la cadena con formato, que puede incluir los caracteres de contraseña.

ToString(Boolean, Boolean)

Devuelve la cadena con formato, que puede incluir caracteres de petición de datos y caracteres literales.

ToString(Boolean, Boolean, Boolean, Int32, Int32)

Devuelve una subcadena de la cadena con formato, que puede incluir caracteres de petición de datos, caracteres literales y caracteres de contraseña.

ToString(Boolean, Boolean, Int32, Int32)

Devuelve una subcadena de la cadena con formato, que puede incluir caracteres de petición de datos y caracteres literales.

ToString(Boolean, Int32, Int32)

Devuelve una subcadena de la cadena con formato, que puede incluir 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 se ha podido establecer correctamente en la posición indicada.

VerifyEscapeChar(Char, Int32)

Comprueba si el carácter especificado sería un carácter de escape en la posición especificada.

VerifyString(String)

Comprueba si la cadena especificada ha podido establecerse correctamente.

VerifyString(String, Int32, MaskedTextResultHint)

Comprueba si la cadena especificada ha podido establecerse correctamente y, a continuación, genera información sobre la posición e información descriptiva.

Se aplica a

Consulte también