MaskedTextProvider.Replace Método

Definição

Namespace:: System.ComponentModel

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Sobrecargas

Nome	Description
Replace(String, Int32, Int32, Int32, MaskedTextResultHint)	Substitui um intervalo de caracteres editáveis entre as posições inicial e final especificadas pela cadeia de caracteres especificada e, em seguida, gera a posição de remoção e as informações descritivas.
Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)	Substitui um único caractere entre as posições inicial e final especificadas pelo valor de 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 na posição especificada pela 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 em ou além da posição especificada pelo valor de 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 pela cadeia de caracteres especificada.
Replace(Char, Int32)	Substitui um único caractere em ou além da posição especificada pelo valor de caractere especificado.

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

Substitui um intervalo de caracteres editáveis entre as posições inicial e final especificadas pela 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 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 String valor usado para substituir os caracteres editáveis existentes.

startPosition: Int32

A posição baseada em zero na cadeia de caracteres formatada em que a substituição é iniciada.

endPosition: Int32

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

testPosition: Int32

Se tiver êxito, a posição baseada em zero na cadeia de caracteres formatada em que o último caractere foi realmente 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 de forma sucinta o resultado da operação de substituição. Um parâmetro de saída.

Retornos

Boolean

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 na 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.

O startPos ponto ou endPos parâmetros 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)

Substitui um único caractere entre as posições inicial e final especificadas pelo valor de 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 Char valor que substitui o valor existente.

startPosition: Int32

A posição baseada em zero na cadeia de caracteres formatada em que a substituição é iniciada.

endPosition: Int32

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

testPosition: Int32

resultHint: MaskedTextResultHint

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

Retornos

Boolean

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 um 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 ser retornado:

O startPos ponto ou endPos parâmetros 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 inputde substituição 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)

Substitui um intervalo de caracteres editáveis começando na posição especificada pela 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 String valor usado para substituir os caracteres editáveis existentes.

position: Int32

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

testPosition: Int32

resultHint: MaskedTextResultHint

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

Retornos

Boolean

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 posespecificada. Operando na 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)

Substitui um único caractere em ou além da posição especificada pelo valor de 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 Char valor que substitui o valor existente.

position: Int32

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

testPosition: Int32

resultHint: MaskedTextResultHint

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

Retornos

Boolean

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 posespecificada. Se um 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 ser 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 inputde substituição 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)

Substitui um intervalo de caracteres editáveis começando na posição especificada pela 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 String valor usado para substituir os caracteres editáveis existentes.

position: Int32

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

Retornos

Boolean

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

Exceções

ArgumentNullException

O input parâmetro é null.

Comentários

O Replace(String, Int32) método pesquisa a primeira posição editável em ou além da posição posespecificada. 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)

Substitui um único caractere em ou além da posição especificada pelo valor de 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 Char valor que substitui o valor existente.

position: Int32

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

Retornos

Boolean

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 posespecificada. Se um 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 ser 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 inputde substituição 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

Comentários

Esta página foi útil?