Compartilhar via


MaskedTextProvider Classe

Definição

Representa um serviço de análise da máscara que pode ser usado por qualquer número de controles que dão suporte a máscara, 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
MaskedTextProvider
Implementações

Comentários

O MaskedTextBox controle contém uma máscara, composta por 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 ao MaskedTextBox, Windows Forms fornece-o MaskedTextProvider como um serviço separado, representado pela classe , que define a sintaxe da linguagem de mascaramento discutida na documentação da Mask propriedade.

Muitos dos membros da MaskedTextBox classe referem sua implementação a membros nomeados da mesma forma do associado MaskedTextProvider. Por exemplo, a MaskedTextBox.PromptChar propriedade da MaskedTextBox classe refere-se a todo o PromptChar acesso ao da MaskedTextProvider classe .

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

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

Nome da cadeia de caracteres Descrição
Caractere de entrada ou cadeia de caracteres Representa os caracteres usados como entrada aos 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 de cadeia de caracteres de entrada estão disponíveis nas AllowPromptAsInput propriedades e AsciiOnly, ResetOnPrompte ResetOnSpace .
Mask 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 pela Mask propriedade . As características da máscara também estão disponíveis por meio de outros membros, como as Lengthpropriedades , 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, LastAssignedPositionMaskFull, MaskCompleted, FindEditPositionFrome assim por diante. O valor completo da cadeia de caracteres formatada está disponível nos ToDisplayString métodos e ToString .

Observação

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)

Inicializa uma nova instância da classe MaskedTextProvider usando a máscara especificada.

MaskedTextProvider(String, Boolean)

Inicializa uma nova instância da classe MaskedTextProvider usando a máscara e o valor de restrição de ASCII especificados.

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)

Inicializa uma nova instância da classe MaskedTextProvider usando a máscara e a cultura especificadas.

MaskedTextProvider(String, CultureInfo, Boolean)

Inicializa uma nova instância da classe MaskedTextProvider usando a máscara, a cultura e o valor de restrição de ASCII 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 de 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.

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ável às quais já foi atribuído um valor de entrada com êxito.

AvailableEditPositionCount

Obtém o número de posições de caractere editável da máscara de entrada às quais ainda não tenha sido atribuído 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 para obscurecer 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 da 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, excluindo todos os caracteres modificadores 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 necessá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 do 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 por seus mesmos valores.

Métodos

Add(Char)

Adiciona o caractere de entrada especificado ao final da cadeia de caracteres formatada.

Add(Char, Int32, MaskedTextResultHint)

Adiciona o caractere de entrada especificado ao final da cadeia de caracteres formatada e, em seguida, gera a posição e as informações descritivas.

Add(String)

Adiciona os caracteres da cadeia de caracteres de entrada especificada, ao final da cadeia de caracteres formatada.

Add(String, Int32, MaskedTextResultHint)

Adiciona os caracteres da cadeia de caracteres de entrada especificada ao final da cadeia de caracteres formatada e, em seguida, gera a posição e as informações descritivas.

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 das MaskedTextProvider atuais.

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)

Insere o caractere especificado na posição especificada na cadeia de caracteres formatada.

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Insere o caractere especificado na posição especificada na 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 na cadeia de caracteres formatada.

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Insere a cadeia de caracteres especificada em uma posição especificada na cadeia de caracteres formatada, retornando a última posição de inserção e o status da operação.

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

(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 da remoção e as informações descritivas.

RemoveAt(Int32)

Remove o caractere atribuído na posição especificada da cadeia de caracteres formatada.

RemoveAt(Int32, Int32)

Remove o caractere atribuído entre as posições especificadas da cadeia de caracteres formatada.

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 da remoção e as informações descritivas.

Replace(Char, Int32)

Substitui um único caractere na posição especificada ou além dela, pelo valor do caractere especificado.

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

Substitui um único caractere, entre a posição final e inicial especificadas, pelo valor do 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 na posição especificada ou além dela, pelo valor do caractere especificado 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 com a cadeia de caracteres especificada.

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

Substitui um intervalo de caracteres editáveis entre as posições inicial e final especificadas com a cadeia de caracteres especificada e, então, gera a posição de remoção e informações descritivas.

Replace(String, Int32, Int32, MaskedTextResultHint)

Substitui um intervalo de caracteres editáveis começando pela posição especificada com a cadeia de caracteres 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.

Set(String, Int32, MaskedTextResultHint)

Define a cadeia de caracteres formatada como a cadeia de caracteres de entrada especificada e, em seguida, gera a posição de remoção e as informações descritivas.

ToDisplayString()

Retorna a cadeia de caracteres formatada em um formato que pode ser exibido.

ToString()

Retorna a cadeia de caracteres formatada que inclui todos os valores de caractere atribuídos.

ToString(Boolean)

Retorna a cadeia de caracteres formatada, incluindo caracteres de senha, opcionalmente.

ToString(Boolean, Boolean)

Retorna a cadeia de caracteres formatada, incluindo, opcionalmente, caracteres de prompt e literais.

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

Retorna uma subcadeia da cadeia de caracteres formatada, incluindo, opcionalmente, caracteres de prompt, de literais e de senha.

ToString(Boolean, Boolean, Int32, Int32)

Retorna uma subcadeia da cadeia de caracteres formatada, incluindo, opcionalmente, caracteres de prompt e literais.

ToString(Boolean, Int32, Int32)

Retorna uma subcadeia da cadeia de caracteres formatada, incluindo, opcionalmente, caracteres de senha.

ToString(Int32, Int32)

Retorna uma subcadeia da cadeia de caracteres formatada.

VerifyChar(Char, Int32, MaskedTextResultHint)

Testa se o caractere especificado pode ser definido na posição especificada com êxito.

VerifyEscapeChar(Char, Int32)

Testa se o caractere especificado seria escapado na posição especificada.

VerifyString(String)

Testa se a cadeia de caracteres especificada pode ser definida com êxito.

VerifyString(String, Int32, MaskedTextResultHint)

Testa se a cadeia de caracteres especificada pode ser definida com êxito e, em seguida, gera a posição e informações descritivas.

Aplica-se a

Confira também