MaskedTextProvider.Add Método

Definição

Namespace:

System.ComponentModel

Assemblies:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Adiciona um caractere de entrada ou uma cadeia de caracteres de entrada à cadeia de caracteres formatada.

Sobrecargas

Nome	Description
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(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)	Adiciona os caracteres na cadeia de caracteres de entrada especificada ao final da cadeia de caracteres formatada.

Add(String, Int32, MaskedTextResultHint)

Origem:

MaskedTextProvider.cs

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.

public:
 bool Add(System::String ^ input, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);

public bool Add(string input, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);

member this.Add : string * int * MaskedTextResultHint -> bool

Public Function Add (input As String, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

Parâmetros

input

String

Um String valor de caractere que contém a ser acrescentado à cadeia de caracteres formatada.

testPosition

Int32

A posição baseada em zero na cadeia de caracteres formatada em que a tentativa foi feita para adicionar o caractere. Um parâmetro de saída.

resultHint

MaskedTextResultHint

Um MaskedTextResultHint que descreve de forma sucinta o resultado da operação. Um parâmetro de saída.

Retornos

Boolean

true se todos os caracteres da cadeia de caracteres de entrada foram adicionados com êxito; caso contrário false , para indicar que nenhum caractere foi adicionado.

Comentários

O Add(String, Int32, MaskedTextResultHint) método adiciona os caracteres da cadeia de input caracteres à cadeia de caracteres formatada, começando com a primeira posição disponível após LastAssignedPosition. Esse método falhará por qualquer um dos seguintes motivos:

• Qualquer um dos caracteres no valor de entrada, inputnão são imprimíveis ou o valor de entrada não corresponde ao elemento de máscara correspondente.

• Não há posições de edição disponíveis suficientes na cadeia de caracteres formatada após a última posição atribuída.

Se esse método falhar, nenhuma adição será feita e o método retornará false.

Esse método funciona da mesma forma que a versão substituída que usa um único String parâmetro, Add(String)exceto pelo fato de gerar informações adicionais.

Confira também

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyString

Add(Char, Int32, MaskedTextResultHint)

Origem:

MaskedTextProvider.cs

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

public:
 bool Add(char input, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);

public bool Add(char input, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);

member this.Add : char * int * MaskedTextResultHint -> bool

Public Function Add (input As Char, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

Parâmetros

input

Char

Um Char valor a ser acrescentado à cadeia de caracteres formatada.

testPosition

Int32

A posição baseada em zero na cadeia de caracteres formatada em que a tentativa foi feita para adicionar o caractere. Um parâmetro de saída.

resultHint

MaskedTextResultHint

Um MaskedTextResultHint que descreve de forma sucinta o resultado da operação. Um parâmetro de saída.

Retornos

Boolean

true se o caractere de entrada foi adicionado com êxito; caso contrário false.

Comentários

O Add(Char, Int32, MaskedTextResultHint) método tenta adicionar o valor do input caractere à primeira posição disponível na cadeia de caracteres formatada após a posição atribuída pela última vez, que é representada pela LastAssignedPosition propriedade. Esse método falhará se todas as posições disponíveis estiverem antes da última posição atribuída. Esse método falhará por qualquer um dos seguintes motivos:

• O valor de entrada não inputé imprimível ou não corresponde ao elemento de máscara correspondente.

• Não há nenhuma posição de edição disponível na cadeia de caracteres formatada ou não há nenhuma posição de edição disponível após a última posição atribuída.

Esse método funciona da mesma forma que a versão substituída que usa um único Char parâmetro, Add(Char)exceto pelo fato de gerar informações adicionais.

Confira também

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyChar(Char, Int32, MaskedTextResultHint)

Add(Char)

Origem:

MaskedTextProvider.cs

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

public:
 bool Add(char input);

public bool Add(char input);

member this.Add : char -> bool

Public Function Add (input As Char) As Boolean

Parâmetros

input

Char

Um Char valor a ser acrescentado à cadeia de caracteres formatada.

Retornos

Boolean

true se o caractere de entrada foi adicionado com êxito; caso contrário false.

Comentários

O Add(Char) método adiciona o valor de input caractere à primeira posição disponível na cadeia de caracteres formatada após a posição atribuída pela última vez, que é representada pela LastAssignedPosition propriedade. Esse método falhará por qualquer um dos seguintes motivos:

• O valor de entrada não inputé imprimível ou não corresponde ao elemento de máscara correspondente.

• Não há nenhuma posição de edição disponível na cadeia de caracteres formatada ou não há nenhuma posição de edição disponível após a última posição atribuída.

Confira também

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyChar(Char, Int32, MaskedTextResultHint)

Add(String)

Origem:

MaskedTextProvider.cs

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

public:
 bool Add(System::String ^ input);

public bool Add(string input);

member this.Add : string -> bool

Public Function Add (input As String) As Boolean

Parâmetros

input

String

Um String valor de caractere que contém a ser acrescentado à cadeia de caracteres formatada.

Retornos

Boolean

true se todos os caracteres da cadeia de caracteres de entrada foram adicionados com êxito; caso contrário false , para indicar que nenhum caractere foi adicionado.

Exceções

ArgumentNullException

O input parâmetro é null.

Comentários

O Add(String) método adiciona os caracteres da cadeia de input caracteres à cadeia de caracteres formatada, começando com a primeira posição disponível após LastAssignedPosition. Esse método falhará por qualquer um dos seguintes motivos:

• Qualquer um dos caracteres no valor de entrada, inputnão são imprimíveis ou o valor de entrada não corresponde ao elemento de máscara correspondente.

• Não há posições de edição disponíveis suficientes na cadeia de caracteres formatada após a última posição atribuída.

Se esse método falhar, nenhuma adição será feita e o método retornará false.

Confira também

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyString