Partilhar via


MaskedTextProvider.InsertAt Método

Definição

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
Origem:
MaskedTextProvider.cs
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

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

Aplica-se a

InsertAt(String, Int32)

Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs
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

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

Exceções

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

Aplica-se a

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs
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

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

Aplica-se a

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs
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

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

Exceções

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

Aplica-se a