MaskedTextProvider.InsertAt Método

Definição

Espaço de Nomes:
System.ComponentModel
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

Insere um carácter ou cadeia numa posição específica dentro da cadeia formatada.

Sobrecargas

Name Description
InsertAt(Char, Int32)

Insere o carácter especificado na posição especificada dentro da cadeia formatada.
InsertAt(String, Int32)

Insere a cadeia especificada numa posição determinada dentro da cadeia formatada.
InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Insere o carácter especificado na posição especificada dentro da cadeia formatada, retornando a última posição de inserção e o estado da operação.
InsertAt(String, Int32, Int32, MaskedTextResultHint)

Insere a cadeia especificada numa posição especificada dentro da cadeia formatada, retornando a última posição de inserção e o estado da operação.

InsertAt(Char, Int32)

Insere o carácter especificado na posição especificada dentro da cadeia 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 inserir.

position
Int32

A posição baseada em zero na cadeia formatada para inserir o carácter.

Devoluções

Boolean

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

Observações

O InsertAt método insere um carácter na primeira posição de edição igual ou além da especificada pelo pos parâmetro. Este método desloca todos os caracteres existentes após o ponto de inserção numa posição para abrir espaço para o carácter inserido input . Se ocorrer um dos seguintes erros, a inserção não é realizada e o método retorna false.

  • O pos parâmetro é inferior a zero ou superior ao Length da cadeia formatada.

  • Um carácter editável não foi encontrado na string formatada na posição especificada ou além dela, pos.

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

  • Não existem posições disponíveis à direita do ponto de inserção, pelo que os caracteres existentes não podem ser deslocados.

  • Mudar as personagens existentes produziria uma violação da máscara.

Uma cadeia vazia input não causará alteração na cadeia formatada, mas devolverá true.

Ver também

Aplica-se a

InsertAt(String, Int32)

Insere a cadeia especificada numa posição determinada dentro da cadeia 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 inserir.

position
Int32

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

Devoluções

Boolean

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

Exceções

ArgumentNullException

O input parâmetro é null.

Observações

O InsertAt método insere cada carácter da input cadeia nas posições de edição localizadas na posição pos e além. Este método desloca todos os caracteres existentes após o ponto de inserção em uma posição para cada carácter inserido. Se ocorrer um dos seguintes erros, não é realizada qualquer inserção, e o método devolve false.

  • O pos parâmetro é inferior a zero ou superior ao Length da cadeia formatada.

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

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

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

  • Mudar as personagens existentes produziria uma violação da máscara. Note que esta mudança ocorre durante a inserção de cada carácter individual.

Uma cadeia vazia input não causará alteração na cadeia formatada, mas devolverá true.

Ver também

Aplica-se a

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Insere o carácter especificado na posição especificada dentro da cadeia formatada, retornando a última posição de inserção e o estado 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 inserir.

position
Int32

A posição baseada em zero na cadeia formatada para inserir o carácter.

testPosition
Int32

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

resultHint
MaskedTextResultHint

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

Devoluções

Boolean

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

Observações

O InsertAt método insere um carácter na primeira posição de edição igual ou além da especificada pelo pos parâmetro. Este método desloca todos os caracteres existentes após o ponto de inserção numa posição para abrir espaço para o carácter inserido input . Se ocorrer um dos seguintes erros, a inserção não é realizada e o método retorna false.

  • O pos parâmetro é inferior a zero ou superior ao Length da cadeia formatada.

  • Um carácter editável não foi encontrado na string formatada na posição especificada ou além dela, pos.

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

  • Não existem posições disponíveis à direita do ponto de inserção, pelo que os caracteres existentes não podem ser deslocados.

  • Mudar as personagens existentes produziria uma violação da máscara.

Uma cadeia vazia input não causará alteração na cadeia formatada, mas devolverá true.

Ver também

Aplica-se a

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Insere a cadeia especificada numa posição especificada dentro da cadeia formatada, retornando a última posição de inserção e o estado 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 inserir.

position
Int32

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

testPosition
Int32

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

resultHint
MaskedTextResultHint

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

Devoluções

Boolean

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

Exceções

ArgumentNullException

O input parâmetro é null.

Observações

O InsertAt método insere cada carácter da input cadeia nas posições de edição localizadas na posição pos e além. Este método desloca todos os caracteres existentes após o ponto de inserção em uma posição para cada carácter inserido. Se ocorrer um dos seguintes erros, não é realizada qualquer inserção, e o método devolve false.

  • O pos parâmetro é inferior a zero ou superior ao Length da cadeia formatada.

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

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

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

  • Mudar as personagens existentes produziria uma violação da máscara. Note que esta mudança ocorre durante a inserção de cada carácter individual.

Uma cadeia vazia input não causará alteração na cadeia formatada, mas devolverá true.

Ver também

Aplica-se a