MaskedTextProvider.Add Método

Definição

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

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

Sobrecargas

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.
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(Char)	Adiciona o caractere de entrada especificado ao final da cadeia de caracteres formatada.
Add(String)	Adiciona os caracteres da cadeia de caracteres de entrada especificada, ao final da cadeia de caracteres formatada.

Add(String, Int32, MaskedTextResultHint)

Origem:

MaskedTextProvider.cs

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.

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

Uma String que contém valores de caractere a serem acrescentados à cadeia de caracteres formatada.

testPosition

Int32

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

resultHint

MaskedTextResultHint

Um MaskedTextResultHint que descreve sucintamente 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, input, nã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 usando um único String parâmetro, Add(String), exceto que ele gera 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 a posição e as informações descritivas.

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 valor Char a ser acrescentado à cadeia de caracteres formatada.

testPosition

Int32

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

resultHint

MaskedTextResultHint

Um MaskedTextResultHint que descreve sucintamente 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 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á 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, input, não é 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 usando um único Char parâmetro, Add(Char), exceto que ele gera 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 valor Char 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, input, não é 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 da 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

Uma String que contém valores de caractere a serem acrescentados à 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 parâmetro input é 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, input, nã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