MaskedTextProvider.Replace Método

Definição

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

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

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

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

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

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

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

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

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

Replace(String, Int32, Int32, MaskedTextResultHint)

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

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

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

Replace(Char, Int32, Int32, MaskedTextResultHint)

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

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

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

Replace(String, Int32)

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

Boolean

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

Exceções

ArgumentNullException

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

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

Replace(Char, Int32)

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

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

• IsValidInputChar(Char)
• FindEditPositionFrom(Int32, Boolean)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set