MaskedTextProvider.InsertAt Método

Definição

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Insere um caractere ou uma cadeia de caracteres em uma posição específica na cadeia de caracteres formatada.

Sobrecargas

InsertAt(Char, Int32)	Insere o caractere especificado na posição especificada na cadeia de caracteres formatada.
InsertAt(String, Int32)	Insere a cadeia de caracteres especificada em uma 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, 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.

InsertAt(Char, Int32)

Origem:

MaskedTextProvider.cs

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

public:
 bool InsertAt(char input, int position);

public bool InsertAt (char input, int position);

member this.InsertAt : char * int -> bool

Public Function InsertAt (input As Char, position As Integer) As Boolean

Parâmetros

input

Char

O Char a ser inserido.

position

Int32

A posição baseada em zero, na cadeia de caracteres formatada, para inserir o caractere.

Retornos

Boolean

true se a inserção foi bem-sucedida; caso contrário, false.

Comentários

O InsertAt método insere um caractere na primeira posição de edição em ou além do especificado pelo pos parâmetro . Esse método deslocará todos os caracteres existentes após o ponto de inserção por uma posição para abrir espaço para o caractere inserido input . Se ocorrer um dos seguintes erros, a inserção não será executada e o método retornará false.

• O pos parâmetro é menor que zero ou maior que o Length da cadeia de caracteres formatada.

• Um caractere editável não foi encontrado na cadeia de caracteres formatada em ou além da posição especificada, pos.

• O caractere de inserção, input, não é um caractere de entrada válido porque não é imprimível ou não corresponde ao elemento de máscara correspondente.

• Não há posições disponíveis à direita do ponto de inserção, de modo que os caracteres existentes não possam ser deslocados.

• A mudança dos caracteres existentes produziria uma violação da máscara.

Uma cadeia de caracteres vazia input não causará nenhuma alteração na cadeia de caracteres formatada, mas retornará true.

Confira também

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(String, Int32)

Origem:

MaskedTextProvider.cs

Insere a cadeia de caracteres especificada em uma posição especificada na cadeia de caracteres formatada.

public:
 bool InsertAt(System::String ^ input, int position);

public bool InsertAt (string input, int position);

member this.InsertAt : string * int -> bool

Public Function InsertAt (input As String, position As Integer) As Boolean

Parâmetros

input

String

O String a ser inserido.

position

Int32

A posição baseada em zero, na cadeia de caracteres formatada, para inserir a cadeia de caracteres de entrada.

Retornos

Boolean

true se a inserção foi bem-sucedida; caso contrário, false.

Exceções

ArgumentNullException

O parâmetro input é null.

Comentários

O InsertAt método insere cada caractere da cadeia de input caracteres nas posições de edição localizadas na posição pos e além. Esse método deslocará todos os caracteres existentes após o ponto de inserção em uma posição para cada caractere inserido. Se ocorrer um dos seguintes erros, nenhuma inserção será executada e o método retornará false.

• O pos parâmetro é menor que zero ou maior que o Length da cadeia de caracteres formatada.

• Não existem caracteres editáveis suficientes na cadeia de caracteres formatada em ou além da posição especificada, pos, para inserir todos os caracteres da input cadeia de caracteres.

• Um ou mais caracteres de inserção não são um caractere de entrada válido porque não são imprimíveis ou não correspondem ao elemento de máscara correspondente.

• Não há posições disponíveis suficientes à direita do ponto de inserção, de modo que os caracteres existentes não possam ser deslocados.

• A mudança dos caracteres existentes produziria uma violação da máscara. Observe que essa mudança ocorre durante a inserção de cada caractere individual.

Uma cadeia de caracteres vazia input não causará nenhuma alteração na cadeia de caracteres formatada, mas retornará true.

Confira também

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Origem:

MaskedTextProvider.cs

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.

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

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

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

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

Parâmetros

input

Char

O Char a ser inserido.

position

Int32

A posição baseada em zero, na cadeia de caracteres formatada, para inserir o caractere.

testPosition

Int32

Se o método for bem-sucedido, a última posição em que foi inserido um caractere; caso contrário, a primeira posição em que a inserção falhou. Um parâmetro de saída.

resultHint

MaskedTextResultHint

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

Retornos

Boolean

true se a inserção foi bem-sucedida; caso contrário, false.

Comentários

O InsertAt método insere um caractere na primeira posição de edição em ou além do especificado pelo pos parâmetro . Esse método deslocará todos os caracteres existentes após o ponto de inserção por uma posição para abrir espaço para o caractere inserido input . Se ocorrer um dos seguintes erros, a inserção não será executada e o método retornará false.

• O pos parâmetro é menor que zero ou maior que o Length da cadeia de caracteres formatada.

• Um caractere editável não foi encontrado na cadeia de caracteres formatada em ou além da posição especificada, pos.

• O caractere de inserção, input, não é um caractere de entrada válido porque não é imprimível ou não corresponde ao elemento de máscara correspondente.

• Não há posições disponíveis à direita do ponto de inserção, de modo que os caracteres existentes não possam ser deslocados.

• A mudança dos caracteres existentes produziria uma violação da máscara.

Uma cadeia de caracteres vazia input não causará nenhuma alteração na cadeia de caracteres formatada, mas retornará true.

Confira também

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Origem:

MaskedTextProvider.cs

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.

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

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

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

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

Parâmetros

input

String

O String a ser inserido.

position

Int32

A posição baseada em zero, na cadeia de caracteres formatada, para inserir a cadeia de caracteres de entrada.

testPosition

Int32

Se o método for bem-sucedido, a última posição em que foi inserido um caractere; caso contrário, a primeira posição em que a inserção falhou. Um parâmetro de saída.

resultHint

MaskedTextResultHint

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

Retornos

Boolean

true se a inserção foi bem-sucedida; caso contrário, false.

Exceções

ArgumentNullException

O parâmetro input é null.

Comentários

O InsertAt método insere cada caractere da cadeia de input caracteres nas posições de edição localizadas na posição pos e além. Esse método deslocará todos os caracteres existentes após o ponto de inserção em uma posição para cada caractere inserido. Se ocorrer um dos seguintes erros, nenhuma inserção será executada e o método retornará false.

• O pos parâmetro é menor que zero ou maior que o Length da cadeia de caracteres formatada.

• Não existem caracteres editáveis suficientes na cadeia de caracteres formatada em ou além da posição especificada, pos, para inserir todos os caracteres da input cadeia de caracteres.

• Um ou mais caracteres de inserção não são um caractere de entrada válido porque não são imprimíveis ou não correspondem ao elemento de máscara correspondente.

• Não há posições disponíveis suficientes à direita do ponto de inserção, de modo que os caracteres existentes não possam ser deslocados.

• A mudança dos caracteres existentes produziria uma violação da máscara. Observe que essa mudança ocorre durante a inserção de cada caractere individual.

Uma cadeia de caracteres vazia input não causará nenhuma alteração na cadeia de caracteres formatada, mas retornará true.

Confira também

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString