Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

MaskedTextProvider (Clase)

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.

System.Object
  System.ComponentModel.MaskedTextProvider

Espacio de nombres:  System.ComponentModel
Ensamblado:  System (en System.dll)

[HostProtectionAttribute(SecurityAction.LinkDemand, SharedState = true)]
public class MaskedTextProvider : ICloneable

El tipo MaskedTextProvider expone los siguientes miembros.

  NombreDescripción
Método públicoMaskedTextProvider(String)Inicializa una nueva instancia de la clase MaskedTextProvider con la máscara especificada.
Método públicoMaskedTextProvider(String, Boolean)Inicializa una nueva instancia de la clase MaskedTextProvider con la máscara y el valor de restricción ASCII especificados.
Método públicoMaskedTextProvider(String, CultureInfo)Inicializa una nueva instancia de la clase MaskedTextProvider con la máscara y referencia cultural especificadas.
Método públicoMaskedTextProvider(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.
Método públicoMaskedTextProvider(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.
Método públicoMaskedTextProvider(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.
Método públicoMaskedTextProvider(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.
Arriba

  NombreDescripción
Propiedad públicaAllowPromptAsInputObtiene 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.
Propiedad públicaAsciiOnlyObtiene un valor que indica si la máscara acepta caracteres que no pertenecen al juego de caracteres ASCII.
Propiedad públicaAssignedEditPositionCountObtiene el número de posiciones de caracteres modificables a las que ya se les ha asignado correctamente un valor de entrada.
Propiedad públicaAvailableEditPositionCountObtiene 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.
Propiedad públicaCultureObtiene la referencia cultural que determina el valor de los separadores y marcadores de posición localizables de la máscara de entrada.
Propiedad públicaMiembro estáticoDefaultPasswordCharObtiene el carácter de contraseña predeterminado que se utiliza para ocultar los datos proporcionados por el usuario.
Propiedad públicaEditPositionCountObtiene el número de posiciones modificables de la cadena con formato.
Propiedad públicaEditPositionsObtiene un enumerador recién creado para las posiciones modificables de la cadena con formato.
Propiedad públicaIncludeLiteralsObtiene o establece un valor que indica si los caracteres literales de la máscara de entrada deben incluirse en la cadena con formato.
Propiedad públicaIncludePromptObtiene 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.
Propiedad públicaMiembro estáticoInvalidIndexObtiene el límite superior del intervalo de índices que no son válidos.
Propiedad públicaIsPasswordObtiene o establece un valor que determina si se debe aplicar protección con contraseña a la cadena con formato.
Propiedad públicaItemObtiene el elemento situado en la posición especificada de la cadena con formato.
Propiedad públicaLastAssignedPositionObtiene 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.
Propiedad públicaLengthObtiene la longitud de la máscara, sin ningún carácter modificador de máscara.
Propiedad públicaMaskObtiene la máscara de entrada.
Propiedad públicaMaskCompletedObtiene un valor que indica si se han especificado todas las entradas obligatorias en la cadena con formato.
Propiedad públicaMaskFullObtiene un valor que indica si se han especificado todas las entradas obligatorias y opcionales en la cadena con formato.
Propiedad públicaPasswordCharObtiene o establece el carácter que se va a sustituir por los caracteres de entrada reales.
Propiedad públicaPromptCharObtiene 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.
Propiedad públicaResetOnPromptObtiene 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.
Propiedad públicaResetOnSpaceObtiene o establece un valor que determina la forma en que debe controlarse un carácter de entrada de espacio.
Propiedad públicaSkipLiteralsObtiene o establece un valor que indica si las posiciones de caracteres literales de la máscara se pueden sobrescribir con sus mismos valores.
Arriba

  NombreDescripción
Método públicoAdd(Char)Agrega el carácter de entrada especificado al final de la cadena con formato.
Método públicoAdd(String)Agrega los caracteres de la cadena de entrada especificada al final de la cadena con formato.
Método públicoAdd(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.
Método públicoAdd(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.
Método públicoClear()Borra todos los caracteres de entrada modificables de la cadena con formato, reemplazándolos por caracteres de petición de datos.
Método públicoClear(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.
Método públicoCloneCrea una copia del objeto MaskedTextProvider actual.
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoFindAssignedEditPositionFromDevuelve 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.
Método públicoFindAssignedEditPositionInRangeDevuelve 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.
Método públicoFindEditPositionFromDevuelve 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.
Método públicoFindEditPositionInRangeDevuelve la posición de la primera posición modificable que se encuentre entre las posiciones especificadas utilizando la dirección de búsqueda indicada.
Método públicoFindNonEditPositionFromDevuelve 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.
Método públicoFindNonEditPositionInRangeDevuelve 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.
Método públicoFindUnassignedEditPositionFromDevuelve 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.
Método públicoFindUnassignedEditPositionInRangeDevuelve 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.
Método públicoGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoMiembro estáticoGetOperationResultFromHintDetermina si la enumeración MaskedTextResultHint especificada denota éxito o error.
Método públicoGetType Obtiene el Typede la instancia actual. (Se hereda de Object).
Método públicoInsertAt(Char, Int32)Inserta el carácter especificado en la posición indicada de la cadena con formato.
Método públicoInsertAt(String, Int32)Inserta la cadena especificada en la posición indicada de la cadena con formato.
Método públicoInsertAt(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.
Método públicoInsertAt(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.
Método públicoIsAvailablePositionDetermina si la posición especificada está disponible para asignarse.
Método públicoIsEditPositionDetermina si la posición especificada es modificable.
Método públicoMiembro estáticoIsValidInputCharDetermina si el carácter especificado es un carácter de entrada válido.
Método públicoMiembro estáticoIsValidMaskCharDetermina si el carácter especificado es un carácter de máscara válido.
Método públicoMiembro estáticoIsValidPasswordCharDetermina si el carácter especificado es un carácter de contraseña válido.
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoRemove()Quita el último carácter asignado de la cadena con formato.
Método públicoRemove(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.
Método públicoRemoveAt(Int32)Quita el carácter asignado de la posición especificada de la cadena con formato.
Método públicoRemoveAt(Int32, Int32)Quita los caracteres asignados situados entre las posiciones especificadas de la cadena con formato.
Método públicoRemoveAt(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.
Método públicoReplace(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.
Método públicoReplace(String, Int32)Reemplaza un intervalo de caracteres modificables por la cadena especificada comenzando en la posición indicada.
Método públicoReplace(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.
Método públicoReplace(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.
Método públicoReplace(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.
Método públicoReplace(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.
Método públicoSet(String)Establece la cadena con formato en la cadena de entrada especificada.
Método públicoSet(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.
Método públicoToDisplayStringDevuelve la cadena con formato en un formato que se pueda mostrar.
Método públicoToString()Devuelve la cadena con formato que contiene todos los valores de caracteres asignados. (Invalida a Object.ToString()).
Método públicoToString(Boolean)Devuelve la cadena con formato, que puede incluir los caracteres de contraseña.
Método públicoToString(Boolean, Boolean)Devuelve la cadena con formato, que puede incluir caracteres de petición de datos y caracteres literales.
Método públicoToString(Int32, Int32)Devuelve una subcadena de la cadena con formato.
Método públicoToString(Boolean, Int32, Int32)Devuelve una subcadena de la cadena con formato, que puede incluir caracteres de contraseña.
Método públicoToString(Boolean, Boolean, Int32, Int32)Devuelve una subcadena de la cadena con formato, que puede incluir caracteres de petición de datos y caracteres literales.
Método públicoToString(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.
Método públicoVerifyCharComprueba si el carácter especificado se ha podido establecer correctamente en la posición indicada.
Método públicoVerifyEscapeCharComprueba si el carácter especificado sería un carácter de escape en la posición especificada.
Método públicoVerifyString(String)Comprueba si la cadena especificada ha podido establecerse correctamente.
Método públicoVerifyString(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.
Arriba

El control MaskedTextBox contiene una máscara, compuesta de caracteres literales y elementos de formato, con la que se comprueban todos los datos proporcionados por el usuario. En lugar de asociar permanentemente un motor de análisis de máscaras concreto al control MaskedTextBox, los formularios Windows Forms proporcionan este servicio como un servicio independiente, representado por la clase MaskedTextProvider, que define la sintaxis del lenguaje de máscaras que se describe en la documentación de la propiedad Mask.

La implementación de muchos de los miembros de la clase MaskedTextBox hace referencia a miembros con nombres similares del objeto MaskedTextProvider asociado. Por ejemplo, todos los tipos de acceso de la propiedad MaskedTextBox.PromptChar de la clase MaskedTextBox hacen referencia a la propiedad PromptChar de la clase MaskedTextProvider.

El objeto MaskedTextProvider utiliza un motor de análisis de máscaras que se basa en el modelo del control Masked Edit incluido en la versión 6 de Microsoft Visual Basic. Su lenguaje de máscaras se describe en la documentación de la propiedad Mask.

A continuación, se muestran tres cadenas distintas relacionadas con la clase MaskedTextProvider.

Nombre de la cadena

Descripción

Carácter o cadena de entrada

Representa los caracteres de entrada a los que se aplica la máscara. En realidad, la cadena de entrada puede estar compuesta de varias operaciones de entrada, como Add, Replace, InsertAt y Remove. Por lo tanto, no se puede obtener acceso directamente a la cadena de entrada. No obstante, los distintos aspectos del control de cadenas de entrada se encuentran disponibles a través de las propiedades AllowPromptAsInput, AsciiOnly, ResetOnPrompt y ResetOnSpace.

Máscara

Representa la máscara de formato de entrada que se utiliza para transformar la cadena de entrada en una cadena con formato. Esta cadena se establece en MaskedTextProvider y se obtiene acceso a ella fundamentalmente a través de la propiedad Mask. Las distintas características de la máscara también se encuentran disponibles a través de otros miembros, como las propiedades Length, PasswordChar y PromptChar.

Cadena con formato

Representa la cadena resultante de aplicar toda la máscara a la cadena de entrada. Para consultar la cadena con formato se pueden utilizar muchos de los miembros de la clase, como Item, Length, LastAssignedPosition, MaskFull, MaskCompleted, FindEditPositionFrom, etc. Se puede obtener acceso al valor total de la cadena con formato a partir de los métodos ToDisplayString y ToString.

NotaNota

La cadena de entrada puede representar los datos directamente proporcionados por el usuario, como en el caso del objeto MaskedTextBox, o puede generarse mediante otros procesos que no estén directamente asociados con las operaciones de entrada o salida del usuario.

NotaNota

El atributo HostProtectionAttribute aplicado a este tipo o miembro tiene el valor de propiedad Resources siguiente: SharedState. El atributo HostProtectionAttribute no afecta a las aplicaciones de escritorio (que normalmente se inician haciendo doble clic en un icono, escribiendo un comando o introduciendo una dirección URL en el explorador). Para obtener más información, vea la clase HostProtectionAttribute o Programación en SQL Server y atributos de protección de host.

.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros públicos static (Shared en Visual Basic) de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft