MaskedTextProvider Classe

Referência

Definição

Namespace:: System.ComponentModel

Assembly:: System.ComponentModel.TypeConverter.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Origem:: MaskedTextProvider.cs

Origem:: MaskedTextProvider.cs

Origem:: MaskedTextProvider.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa um serviço de análise de máscara que pode ser usado por qualquer número de controles que dão suporte ao mascaramento, como o controle MaskedTextBox.

public ref class MaskedTextProvider : ICloneable

public class MaskedTextProvider : ICloneable

type MaskedTextProvider = class
    interface ICloneable

Public Class MaskedTextProvider
Implements ICloneable

Herança: Object
MaskedTextProvider

Implementações: ICloneable

Comentários

O controle MaskedTextBox contém uma máscara, composta de caracteres literais e elementos de formatação, em que testa todas as entradas do usuário. Em vez de associar permanentemente um mecanismo de análise de máscara específico a MaskedTextBox, o Windows Forms fornece-o como um serviço separado, representado pela classe MaskedTextProvider, que define a sintaxe da linguagem de mascaramento discutida na documentação da propriedade Mask.

Muitos dos membros da classe MaskedTextBox referem sua implementação a membros similarmente nomeados do MaskedTextProviderassociado. Por exemplo, a propriedade MaskedTextBox.PromptChar da classe MaskedTextBox refere todo o acesso ao PromptChar da classe MaskedTextProvider.

O mecanismo de análise de máscara usado pelo MaskedTextProvider é modelado após o controle Editar Mascarado incluído no Microsoft Visual Basic versão 6. Sua linguagem de mascaramento é descrita na documentação da propriedade Mask.

As três cadeias de caracteres distintas a seguir estão envolvidas com a classe MaskedTextProvider.

Nome da cadeia de caracteres	Descrição
Caractere de entrada ou cadeia de caracteres	Representa os caracteres usados como entrada nos quais a máscara é aplicada. Na verdade, a cadeia de caracteres de entrada pode ser composta por várias operações de entrada, incluindo Add, Replace, InsertAte Remove. Portanto, a cadeia de caracteres de entrada não pode ser acessada diretamente. No entanto, aspectos do tratamento da cadeia de caracteres de entrada estão disponíveis, embora as propriedades AllowPromptAsInput e AsciiOnly, ResetOnPrompte ResetOnSpace.
Máscara	Representa a máscara de formatação de entrada usada para transformar a cadeia de caracteres de entrada na cadeia de caracteres formatada. Essa cadeia de caracteres é definida no MaskedTextProvider e acessada principalmente na propriedade Mask. As características da máscara também estão disponíveis por meio de outros membros, como as propriedades Length, PasswordChare PromptChar.
Cadeia de caracteres formatada	Representa a cadeia de caracteres que resulta quando a máscara completa é aplicada à cadeia de caracteres de entrada. A cadeia de caracteres formatada pode ser consultada com muitos membros da classe, incluindo Item[], Length, LastAssignedPosition, MaskFull, MaskCompleted, FindEditPositionFrome assim por diante. O valor completo da cadeia de caracteres formatada está disponível nos métodos ToDisplayString e ToString.

Nota

A cadeia de caracteres de entrada pode representar a entrada direta do usuário, como no caso do MaskedTextBox, ou pode ser gerada por outros processos não diretamente associados a operações de entrada/saída do usuário.

Construtores

MaskedTextProvider(String, Boolean)	Inicializa uma nova instância da classe MaskedTextProvider usando a máscara especificada e o valor de restrição ASCII.
MaskedTextProvider(String, Char, Boolean)	Inicializa uma nova instância da classe MaskedTextProvider usando a máscara, o caractere de senha e o valor de uso do prompt especificados.
MaskedTextProvider(String, CultureInfo, Boolean, Char, Char, Boolean)	Inicializa uma nova instância da classe MaskedTextProvider usando a máscara, a cultura, o valor de uso do prompt, o caractere de prompt, o caractere de senha e o valor de restrição ASCII especificados.
MaskedTextProvider(String, CultureInfo, Boolean)	Inicializa uma nova instância da classe MaskedTextProvider usando a máscara, a cultura e o valor de restrição ASCII especificados.
MaskedTextProvider(String, CultureInfo, Char, Boolean)	Inicializa uma nova instância da classe MaskedTextProvider usando a máscara, a cultura, o caractere de senha e o valor de uso do prompt especificados.
MaskedTextProvider(String, CultureInfo)	Inicializa uma nova instância da classe MaskedTextProvider usando a máscara e a cultura especificadas.
MaskedTextProvider(String)	Inicializa uma nova instância da classe MaskedTextProvider usando a máscara especificada.

Propriedades

AllowPromptAsInput	Obtém um valor que indica se o caractere de prompt deve ser tratado como um caractere de entrada válido ou não.
AsciiOnly	Obtém um valor que indica se a máscara aceita caracteres fora do conjunto de caracteres ASCII.
AssignedEditPositionCount	Obtém o número de posições de caractere editáveis que já foram atribuídas com êxito a um valor de entrada.
AvailableEditPositionCount	Obtém o número de posições de caractere editáveis na máscara de entrada que ainda não receberam um valor de entrada.
Culture	Obtém a cultura que determina o valor dos separadores e espaços reservados localizáveis na máscara de entrada.
DefaultPasswordChar	Obtém o caractere de senha padrão usado obscurece a entrada do usuário.
EditPositionCount	Obtém o número de posições editáveis na cadeia de caracteres formatada.
EditPositions	Obtém um enumerador recém-criado para as posições editáveis na cadeia de caracteres formatada.
IncludeLiterals	Obtém ou define um valor que indica se os caracteres literais na máscara de entrada devem ser incluídos na cadeia de caracteres formatada.
IncludePrompt	Obtém ou define um valor que indica se PromptChar é usado para representar a ausência de entrada do usuário ao exibir a cadeia de caracteres formatada.
InvalidIndex	Obtém o limite superior do intervalo de índices inválidos.
IsPassword	Obtém ou define um valor que determina se a proteção por senha deve ser aplicada à cadeia de caracteres formatada.
Item[Int32]	Obtém o elemento na posição especificada na cadeia de caracteres formatada.
LastAssignedPosition	Obtém o índice na máscara do caractere de entrada mais à direita que foi atribuído à máscara.
Length	Obtém o comprimento da máscara, sem qualquer caractere modificador de máscara.
Mask	Obtém a máscara de entrada.
MaskCompleted	Obtém um valor que indica se todas as entradas necessárias foram inseridas na cadeia de caracteres formatada.
MaskFull	Obtém um valor que indica se todas as entradas obrigatórias e opcionais foram inseridas na cadeia de caracteres formatada.
PasswordChar	Obtém ou define o caractere a ser substituído pelos caracteres de entrada reais.
PromptChar	Obtém ou define o caractere usado para representar a ausência de entrada do usuário para todas as posições de edição disponíveis.
ResetOnPrompt	Obtém ou define um valor que determina como um caractere de entrada que corresponde ao caractere de prompt deve ser tratado.
ResetOnSpace	Obtém ou define um valor que determina como um caractere de entrada de espaço deve ser tratado.
SkipLiterals	Obtém ou define um valor que indica se as posições de caractere literal na máscara podem ser substituídas pelos mesmos valores.

Métodos

Add(Char, Int32, MaskedTextResultHint)	Adiciona o caractere de entrada especificado ao final da cadeia de caracteres formatada e, em seguida, gera informações descritivas e de posição.
Add(Char)	Adiciona o caractere de entrada especificado ao final da cadeia de caracteres formatada.
Add(String, Int32, MaskedTextResultHint)	Adiciona os caracteres na cadeia de caracteres de entrada especificada ao final da cadeia de caracteres formatada e, em seguida, gera informações descritivas e de posição.
Add(String)	Adiciona os caracteres na cadeia de caracteres de entrada especificada ao final da cadeia de caracteres formatada.
Clear()	Limpa todos os caracteres de entrada editáveis da cadeia de caracteres formatada, substituindo-os por caracteres de prompt.
Clear(MaskedTextResultHint)	Limpa todos os caracteres de entrada editáveis da cadeia de caracteres formatada, substituindo-os por caracteres de prompt e, em seguida, gera informações descritivas.
Clone()	Cria uma cópia do MaskedTextProvideratual.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindAssignedEditPositionFrom(Int32, Boolean)	Retorna a posição da primeira posição editável atribuída após a posição especificada usando a direção de pesquisa especificada.
FindAssignedEditPositionInRange(Int32, Int32, Boolean)	Retorna a posição da primeira posição editável atribuída entre as posições especificadas usando a direção de pesquisa especificada.
FindEditPositionFrom(Int32, Boolean)	Retorna a posição da primeira posição editável após a posição especificada usando a direção de pesquisa especificada.
FindEditPositionInRange(Int32, Int32, Boolean)	Retorna a posição da primeira posição editável entre as posições especificadas usando a direção de pesquisa especificada.
FindNonEditPositionFrom(Int32, Boolean)	Retorna a posição da primeira posição não editável após a posição especificada usando a direção de pesquisa especificada.
FindNonEditPositionInRange(Int32, Int32, Boolean)	Retorna a posição da primeira posição não editável entre as posições especificadas usando a direção de pesquisa especificada.
FindUnassignedEditPositionFrom(Int32, Boolean)	Retorna a posição da primeira posição editável não atribuída após a posição especificada usando a direção de pesquisa especificada.
FindUnassignedEditPositionInRange(Int32, Int32, Boolean)	Retorna a posição da primeira posição editável não atribuída entre as posições especificadas usando a direção de pesquisa especificada.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetOperationResultFromHint(MaskedTextResultHint)	Determina se o MaskedTextResultHint especificado indica êxito ou falha.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InsertAt(Char, Int32, Int32, MaskedTextResultHint)	Insere o caractere especificado na posição especificada dentro da cadeia de caracteres formatada, retornando a última posição de inserção e o status da operação.
InsertAt(Char, Int32)	Insere o caractere especificado na posição especificada dentro da cadeia de caracteres formatada.
InsertAt(String, Int32, Int32, MaskedTextResultHint)	Insere a cadeia de caracteres especificada em uma posição especificada dentro da cadeia de caracteres formatada, retornando a última posição de inserção e o status da operação.
InsertAt(String, Int32)	Insere a cadeia de caracteres especificada em uma posição especificada dentro da cadeia de caracteres formatada.
IsAvailablePosition(Int32)	Determina se a posição especificada está disponível para atribuição.
IsEditPosition(Int32)	Determina se a posição especificada é editável.
IsValidInputChar(Char)	Determina se o caractere especificado é um caractere de entrada válido.
IsValidMaskChar(Char)	Determina se o caractere especificado é um caractere de máscara válido.
IsValidPasswordChar(Char)	Determina se o caractere especificado é um caractere de senha válido.
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
Remove()	Remove o último caractere atribuído da cadeia de caracteres formatada.
Remove(Int32, MaskedTextResultHint)	Remove o último caractere atribuído da cadeia de caracteres formatada e, em seguida, gera a posição de remoção e as informações descritivas.
RemoveAt(Int32, Int32, Int32, MaskedTextResultHint)	Remove os caracteres atribuídos entre as posições especificadas da cadeia de caracteres formatada e, em seguida, gera a posição de remoção e as informações descritivas.
RemoveAt(Int32, Int32)	Remove os caracteres atribuídos entre as posições especificadas da cadeia de caracteres formatada.
RemoveAt(Int32)	Remove o caractere atribuído na posição especificada da cadeia de caracteres formatada.
Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)	Substitui um único caractere entre as posições inicial e final especificadas pelo valor de caractere especificado e, em seguida, gera a posição de remoção e as informações descritivas.
Replace(Char, Int32, Int32, MaskedTextResultHint)	Substitui um único caractere em ou além da posição especificada pelo valor de caractere especificado e, em seguida, gera a posição de remoção e as informações descritivas.
Replace(Char, Int32)	Substitui um único caractere em ou além da posição especificada pelo valor de caractere especificado.
Replace(String, Int32, Int32, Int32, MaskedTextResultHint)	Substitui um intervalo de caracteres editáveis entre as posições inicial e final especificadas pela cadeia de caracteres especificada e, em seguida, gera a posição de remoção e as informações descritivas.
Replace(String, Int32, Int32, MaskedTextResultHint)	Substitui um intervalo de caracteres editáveis começando na posição especificada pela cadeia de caracteres especificada e, em seguida, gera a posição de remoção e as informações descritivas.
Replace(String, Int32)	Substitui um intervalo de caracteres editáveis começando na posição especificada pela cadeia de caracteres especificada.
Set(String, Int32, MaskedTextResultHint)	Define a cadeia de caracteres formatada para a cadeia de caracteres de entrada especificada e, em seguida, gera a posição de remoção e as informações descritivas.
Set(String)	Define a cadeia de caracteres formatada como a cadeia de caracteres de entrada especificada.
ToDisplayString()	Retorna a cadeia de caracteres formatada em um formulário exibivel.
ToString()	Retorna a cadeia de caracteres formatada que inclui todos os valores de caractere atribuídos.
ToString(Boolean, Boolean, Boolean, Int32, Int32)	Retorna uma subcadeia de caracteres da cadeia de caracteres formatada, incluindo opcionalmente caracteres de prompt, literal e senha.
ToString(Boolean, Boolean, Int32, Int32)	Retorna uma subcadeia de caracteres da cadeia de caracteres formatada, incluindo opcionalmente caracteres de prompt e literal.
ToString(Boolean, Boolean)	Retorna a cadeia de caracteres formatada, opcionalmente incluindo caracteres de prompt e literal.
ToString(Boolean, Int32, Int32)	Retorna uma subcadeia de caracteres da cadeia de caracteres formatada, incluindo opcionalmente caracteres de senha.
ToString(Boolean)	Retorna a cadeia de caracteres formatada, incluindo opcionalmente caracteres de senha.
ToString(Int32, Int32)	Retorna uma subcadeia de caracteres da cadeia de caracteres formatada.
VerifyChar(Char, Int32, MaskedTextResultHint)	Testa se o caractere especificado pode ser definido com êxito na posição especificada.
VerifyEscapeChar(Char, Int32)	Testa se o caractere especificado seria escapado na posição especificada.
VerifyString(String, Int32, MaskedTextResultHint)	Testa se a cadeia de caracteres especificada pode ser definida com êxito e, em seguida, gera informações descritivas e de posição.
VerifyString(String)	Testa se a cadeia de caracteres especificada pode ser definida com êxito.

Aplica-se a

Partilhar via