Compartilhar via


MaskedTextProvider.Replace Método

Definição

Substitui um ou mais caracteres editáveis da cadeia de caracteres formatada pelos caracteres especificados.

Sobrecargas

Replace(String, Int32, Int32, Int32, MaskedTextResultHint)

Substitui um intervalo de caracteres editáveis entre as posições inicial e final especificadas com a cadeia de caracteres especificada e, então, gera a posição de remoção e informações descritivas.

Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)

Substitui um único caractere, entre a posição final e inicial especificadas, pelo valor do caractere especificado e, em seguida, gera a posição de remoção e as informações descritivas.

Replace(String, Int32, Int32, MaskedTextResultHint)

Substitui um intervalo de caracteres editáveis começando pela posição especificada com a cadeia de caracteres especificada e, em seguida, gera a posição de remoção e as informações descritivas.

Replace(Char, Int32, Int32, MaskedTextResultHint)

Substitui um único caractere na posição especificada ou além dela, pelo valor do caractere especificado e, em seguida, gera a posição de remoção e as informações descritivas.

Replace(String, Int32)

Substitui um intervalo de caracteres editáveis, começando na posição especificada com a cadeia de caracteres especificada.

Replace(Char, Int32)

Substitui um único caractere na posição especificada ou além dela, pelo valor do caractere especificado.

Replace(String, Int32, Int32, Int32, MaskedTextResultHint)

Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs

Substitui um intervalo de caracteres editáveis entre as posições inicial e final especificadas com a cadeia de caracteres especificada e, então, gera a posição de remoção e informações descritivas.

public:
 bool Replace(System::String ^ input, int startPosition, int endPosition, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool Replace (string input, int startPosition, int endPosition, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.Replace : string * int * int * int * MaskedTextResultHint -> bool
Public Function Replace (input As String, startPosition As Integer, endPosition As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

Parâmetros

input
String

O valor String usado para substituir os caracteres editáveis existentes.

startPosition
Int32

A posição baseada em zero na cadeia de caracteres formatada na qual começa a substituição.

endPosition
Int32

A posição baseada em zero na cadeia de caracteres formatada na qual termina a substituição.

testPosition
Int32

Se tiver êxito, a posição baseada em zero na cadeia de caracteres formatada em que o último caractere foi, na verdade, substituído; caso contrário, a primeira posição em que a operação falhou. Um parâmetro de saída.

resultHint
MaskedTextResultHint

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

Retornos

true se todos os caracteres foram substituídos com êxito; caso contrário, false.

Comentários

O Replace método pesquisa a primeira posição editável na cadeia de caracteres formatada entre as posições inicial e final especificadas. Operando com a suposição de que há posições editáveis suficientes após esse ponto, os valores de caractere existentes são substituídos um por um pelo conteúdo do parâmetro de cadeia de caracteres de substituição, input.

As condições a seguir são consideradas erros. Quando ocorre um erro, nenhuma substituição ocorre e Replace retorna false.

  • Os startPos parâmetros ou endPos apontam antes do início da cadeia de caracteres formatada ou além de seu final.

  • Não há posições editáveis suficientes na cadeia de caracteres formatada para manter o conteúdo da cadeia de caracteres de substituição.

  • Um dos valores de caractere de substituição não é válido porque não é imprimível ou não corresponde ao elemento de máscara correspondente.

Além do valor retornado, esse método tem dois parâmetros de saída para fornecer informações adicionais sobre a operação de substituição.

Confira também

Aplica-se a

Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)

Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs

Substitui um único caractere, entre a posição final e inicial especificadas, pelo valor do caractere especificado e, em seguida, gera a posição de remoção e as informações descritivas.

public:
 bool Replace(char input, int startPosition, int endPosition, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool Replace (char input, int startPosition, int endPosition, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.Replace : char * int * int * int * MaskedTextResultHint -> bool
Public Function Replace (input As Char, startPosition As Integer, endPosition As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

Parâmetros

input
Char

O valor Char que substitui o valor existente.

startPosition
Int32

A posição baseada em zero na cadeia de caracteres formatada na qual começa a substituição.

endPosition
Int32

A posição baseada em zero na cadeia de caracteres formatada na qual termina a substituição.

testPosition
Int32

Se tiver êxito, a posição baseada em zero na cadeia de caracteres formatada em que o último caractere foi, na verdade, substituído; caso contrário, a primeira posição em que a operação falhou. Um parâmetro de saída.

resultHint
MaskedTextResultHint

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

Retornos

true se o caractere foi substituído com êxito; caso contrário, false.

Comentários

O Replace(Char, Int32, Int32, Int32, MaskedTextResultHint) método pesquisa a primeira posição editável na cadeia de caracteres formatada entre as posições inicial e final especificadas. Se for encontrado, o valor da posição editável será alterado para o caractere especificado, input. Qualquer uma das seguintes condições resultará em uma condição de erro que faz com que nenhuma substituição seja executada e um valor de false seja retornado:

  • Os startPos parâmetros ou endPos apontam antes do início da cadeia de caracteres formatada ou além de seu final.

  • Um caractere editável não foi encontrado no intervalo especificado.

  • O caractere de substituiçã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.

Além do valor retornado, esse método tem dois parâmetros de saída para fornecer informações adicionais sobre a operação de substituição.

Confira também

Aplica-se a

Replace(String, Int32, Int32, MaskedTextResultHint)

Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs

Substitui um intervalo de caracteres editáveis começando pela posição especificada com a cadeia de caracteres especificada e, em seguida, gera a posição de remoção e as informações descritivas.

public:
 bool Replace(System::String ^ input, int position, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool Replace (string input, int position, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.Replace : string * int * int * MaskedTextResultHint -> bool
Public Function Replace (input As String, position As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

Parâmetros

input
String

O valor String usado para substituir os caracteres editáveis existentes.

position
Int32

A posição baseada em zero para pesquisar o primeiro caractere editável a ser substituído.

testPosition
Int32

Se tiver êxito, a posição baseada em zero na cadeia de caracteres formatada em que o último caractere foi, na verdade, substituído; caso contrário, a primeira posição em que a operação falhou. Um parâmetro de saída.

resultHint
MaskedTextResultHint

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

Retornos

true se todos os caracteres foram substituídos com êxito; caso contrário, false.

Comentários

O Replace(String, Int32, Int32, MaskedTextResultHint) método pesquisa a primeira posição editável em ou além da posição especificada, pos. Operando com a suposição de que há posições editáveis suficientes após esse ponto, os valores de caractere existentes são substituídos um por um pelo conteúdo do parâmetro de cadeia de caracteres de substituição, input.

As condições a seguir são consideradas erros. Quando ocorre um erro, nenhuma substituição ocorre e Replace(String, Int32, Int32, MaskedTextResultHint) retorna false.

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

  • Não há posições editáveis suficientes na cadeia de caracteres formatada para manter o conteúdo da cadeia de caracteres de substituição.

  • Um dos valores de caractere de substituição não é válido porque não é imprimível ou não corresponde ao elemento de máscara correspondente.

Além do valor retornado, esse método tem dois parâmetros de saída para fornecer informações adicionais sobre a operação de substituição.

Confira também

Aplica-se a

Replace(Char, Int32, Int32, MaskedTextResultHint)

Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs

Substitui um único caractere na posição especificada ou além dela, pelo valor do caractere especificado e, em seguida, gera a posição de remoção e as informações descritivas.

public:
 bool Replace(char input, int position, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool Replace (char input, int position, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.Replace : char * int * int * MaskedTextResultHint -> bool
Public Function Replace (input As Char, position As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

Parâmetros

input
Char

O valor Char que substitui o valor existente.

position
Int32

A posição baseada em zero para pesquisar o primeiro caractere editável a ser substituído.

testPosition
Int32

Se tiver êxito, a posição baseada em zero na cadeia de caracteres formatada em que o último caractere foi, na verdade, substituído; caso contrário, a primeira posição em que a operação falhou. Um parâmetro de saída.

resultHint
MaskedTextResultHint

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

Retornos

true se o caractere foi substituído com êxito; caso contrário, false.

Comentários

O Replace(Char, Int32, Int32, MaskedTextResultHint) método pesquisa a primeira posição editável na cadeia de caracteres formatada em ou além da posição especificada, pos. Se for encontrado, o valor da posição editável será alterado para o caractere especificado, input. Qualquer uma das seguintes condições resultará em uma condição de erro que faz com que nenhuma substituição seja executada e um valor de false seja retornado:

  • 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 substituiçã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.

Além do valor retornado, esse método tem dois parâmetros de saída para fornecer informações adicionais sobre a operação de substituição.

Confira também

Aplica-se a

Replace(String, Int32)

Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs

Substitui um intervalo de caracteres editáveis, começando na posição especificada com a cadeia de caracteres especificada.

public:
 bool Replace(System::String ^ input, int position);
public bool Replace (string input, int position);
member this.Replace : string * int -> bool
Public Function Replace (input As String, position As Integer) As Boolean

Parâmetros

input
String

O valor String usado para substituir os caracteres editáveis existentes.

position
Int32

A posição baseada em zero para pesquisar o primeiro caractere editável a ser substituído.

Retornos

true se todos os caracteres foram substituídos com êxito; caso contrário, false.

Exceções

O parâmetro input é null.

Comentários

O Replace(String, Int32) método pesquisa a primeira posição editável em ou além da posição especificada, pos. Operando sob a suposição de que há posições editáveis suficientes após esse ponto, os valores de caractere existentes são substituídos um por um pelo conteúdo do parâmetro de cadeia de caracteres de substituição, input.

As condições a seguir são consideradas erros. Quando ocorre um erro, nenhuma substituição ocorre e Replace(String, Int32) retorna false.

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

  • Não há posições editáveis suficientes na cadeia de caracteres formatada para manter o conteúdo da cadeia de caracteres de substituição.

  • Um dos valores de caractere de substituição não é válido porque não é imprimível ou não corresponde ao elemento de máscara correspondente.

Confira também

Aplica-se a

Replace(Char, Int32)

Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs

Substitui um único caractere na posição especificada ou além dela, pelo valor do caractere especificado.

public:
 bool Replace(char input, int position);
public bool Replace (char input, int position);
member this.Replace : char * int -> bool
Public Function Replace (input As Char, position As Integer) As Boolean

Parâmetros

input
Char

O valor Char que substitui o valor existente.

position
Int32

A posição baseada em zero para pesquisar o primeiro caractere editável a ser substituído.

Retornos

true se o caractere foi substituído com êxito; caso contrário, false.

Comentários

O Replace(Char, Int32) método pesquisa a primeira posição editável na cadeia de caracteres formatada em ou além da posição especificada, pos. Se for encontrado, o valor da posição editável será alterado para o caractere especificado, input. Qualquer uma das seguintes condições resultará em um erro que faz com que nenhuma substituição seja executada e um valor de false seja retornado:

  • 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 substituiçã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.

Confira também

Aplica-se a