MaskedTextProvider.Replace Método

Definição

Espaço de Nomes:: System.ComponentModel

Assemblagem:: System.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

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

Sobrecargas

Name	Description
Replace(String, Int32, Int32, Int32, MaskedTextResultHint)	Substitui um conjunto de caracteres editáveis entre as posições inicial e final especificadas pela cadeia especificada, e depois apresenta a posição de remoção e a informação descritiva.
Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)	Substitui um único carácter entre as posições inicial e final especificadas pelo valor de carácter especificado, e depois gera a posição de remoção e a informação descritiva.
Replace(String, Int32, Int32, MaskedTextResultHint)	Substitui um conjunto de caracteres editáveis que começam na posição especificada pela cadeia especificada, e depois apresenta a posição de remoção e a informação descritiva.
Replace(Char, Int32, Int32, MaskedTextResultHint)	Substitui um único carácter na posição especificada ou além da posição especificada pelo valor especificado, e depois apresenta a posição de remoção e a informação descritiva.
Replace(String, Int32)	Substitui um conjunto de caracteres editáveis a partir da posição especificada pela cadeia especificada.
Replace(Char, Int32)	Substitui um único carácter na posição especificada ou além da posição especificada pelo valor de carácter especificado.

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

Substitui um conjunto de caracteres editáveis entre as posições inicial e final especificadas pela cadeia especificada, e depois apresenta a posição de remoção e a informação descritiva.

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 string formatada onde a substituição começa.

endPosition: Int32

A posição baseada em zero na string formatada onde termina a substituição.

testPosition: Int32

Se bem-sucedido, a posição baseada em zero na cadeia formatada onde o último carácter 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

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

Devoluções

Boolean

true se todas as personagens fossem substituídas com sucesso; caso contrário, false.

Observações

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

As seguintes condições são consideradas erros. Quando ocorre um erro, não ocorre substituição e Replace devolve false.

Os startPos parâmetros ou endPos apontam antes do início da cadeia formatada ou para além do seu fim.
Não há posições editáveis suficientes na string formatada para conter o conteúdo da string de substituição.
Um dos valores de caracteres de substituição não é válido porque não é imprimível ou não corresponde ao elemento correspondente da máscara.

Além do valor de retorno, este método tem dois parâmetros de saída para fornecer informação adicional sobre a operação de substituição.

Ver também

Aplica-se a

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

Substitui um único carácter entre as posições inicial e final especificadas pelo valor de carácter especificado, e depois gera a posição de remoção e a informação descritiva.

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 string formatada onde a substituição começa.

endPosition: Int32

A posição baseada em zero na string formatada onde termina a substituição.

testPosition: Int32

resultHint: MaskedTextResultHint

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

Devoluções

Boolean

true se a personagem fosse substituída com sucesso; caso contrário, false.

Observações

O Replace(Char, Int32, Int32, Int32, MaskedTextResultHint) método procura a primeira posição editável na cadeia formatada entre as posições inicial e final especificadas. Se for encontrado um, o valor da posição editável é alterado para o carácter especificado, input. Qualquer uma das seguintes condições resultará numa condição de erro que impede a realização de substituição e um valor de false será devolvido:

Os startPos parâmetros ou endPos apontam antes do início da cadeia formatada ou para além do seu fim.
Não foi encontrado um carácter editável no intervalo especificado.
O carácter de substituiçã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.

Além do valor de retorno, este método tem dois parâmetros de saída para fornecer informação adicional sobre a operação de substituição.

Ver também

Aplica-se a

Replace(String, Int32, Int32, MaskedTextResultHint)

Substitui um conjunto de caracteres editáveis que começam na posição especificada pela cadeia especificada, e depois apresenta a posição de remoção e a informação descritiva.

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 base zero para procurar o primeiro carácter editável a substituir.

testPosition: Int32

resultHint: MaskedTextResultHint

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

Devoluções

Boolean

true se todas as personagens fossem substituídas com sucesso; caso contrário, false.

Observações

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

As seguintes condições são consideradas erros. Quando ocorre um erro, não ocorre substituição e Replace(String, Int32, Int32, MaskedTextResultHint) devolve false.

O pos parâmetro é inferior a zero ou superior ao Length da cadeia formatada.
Não há posições editáveis suficientes na string formatada para conter o conteúdo da string de substituição.
Um dos valores de caracteres de substituição não é válido porque não é imprimível ou não corresponde ao elemento correspondente da máscara.

Além do valor de retorno, este método tem dois parâmetros de saída para fornecer informação adicional sobre a operação de substituição.

Ver também

Aplica-se a

Replace(Char, Int32, Int32, MaskedTextResultHint)

Substitui um único carácter na posição especificada ou além da posição especificada pelo valor especificado, e depois apresenta a posição de remoção e a informação descritiva.

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 base zero para procurar o primeiro carácter editável a substituir.

testPosition: Int32

resultHint: MaskedTextResultHint

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

Devoluções

Boolean

true se a personagem fosse substituída com sucesso; caso contrário, false.

Observações

O Replace(Char, Int32, Int32, MaskedTextResultHint) método procura a primeira posição editável na cadeia formatada na posição especificada ou para além dela, pos. Se for encontrado um, o valor da posição editável é alterado para o carácter especificado, input. Qualquer uma das seguintes condições resultará numa condição de erro que impede a realização de substituição e um valor de false será devolvido:

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

Além do valor de retorno, este método tem dois parâmetros de saída para fornecer informação adicional sobre a operação de substituição.

Ver também

Aplica-se a

Replace(String, Int32)

Substitui um conjunto de caracteres editáveis a partir da posição especificada pela cadeia 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 base zero para procurar o primeiro carácter editável a substituir.

Devoluções

Boolean

true se todas as personagens fossem substituídas com sucesso; caso contrário, false.

Exceções

ArgumentNullException

O input parâmetro é null.

Observações

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

As seguintes condições são consideradas erros. Quando ocorre um erro, não ocorre substituição e Replace(String, Int32) devolve false.

O pos parâmetro é inferior a zero ou superior ao Length da cadeia formatada.
Não há posições editáveis suficientes na string formatada para conter o conteúdo da string de substituição.
Um dos valores de caracteres de substituição não é válido porque não é imprimível ou não corresponde ao elemento correspondente da máscara.

Ver também

Aplica-se a

Replace(Char, Int32)

Substitui um único carácter na posição especificada ou além da posição especificada pelo valor de carácter 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 base zero para procurar o primeiro carácter editável a substituir.

Devoluções

Boolean

true se a personagem fosse substituída com sucesso; caso contrário, false.

Observações

O Replace(Char, Int32) método procura a primeira posição editável na cadeia formatada na posição especificada ou para além dela, pos. Se for encontrado um, o valor da posição editável é alterado para o carácter especificado, input. Qualquer uma das seguintes condições resultará num erro que impede a realização de substituição e o valor de false será devolvido:

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

Ver também

Aplica-se a

Comentários

Esta página foi útil?