Função Replace (Visual Basic)
Retorna uma sequência de caracteres na qual uma subsequência de caracteres especificada foi substituída por outra subsequência um determinado número de vezes.
Public Function Replace(
ByVal Expression As String,
ByVal Find As String,
ByVal Replacement As String,
Optional ByVal Start As Integer = 1,
Optional ByVal Count As Integer = -1,
Optional ByVal Compare As CompareMethod = CompareMethod.Binary
) As String
Parâmetros
Expression
Obrigatório.Expressão em sequência de caracteres que contém a subsequência de caracteres para substituir.Find
Obrigatório.Subsequência sendo procurada.Replacement
Obrigatório.Subsequência de substituição.Start
Opcional.Posicione Expression onde subsequência de pesquisa deve começar.Se omitido, 1 será adotado.Count
Opcional.Número de substituições de subsequências a executar.Se for omitido, o valor padrão será – 1, o que significa "fazer todas as substituições possíveis."Compare
Opcional.Valor numérico indicando a comparação para usar ao avaliar substrings.Consulte "Configurações" para os valores.
Configurações
O argumento Compare pode ter os seguintes valores.
Constante |
Descrição |
|---|---|
Binary |
Executa uma comparação binária. |
Text |
Executa uma comparação textual |
Valor de retorno
Replace retorna os valores a seguir.
Se |
Replace retorna |
|---|---|
Find tem comprimento zero ou Nothing |
Cópia de Expression |
Replace tem comprimento zero |
Cópia de Expression com nenhuma ocorrência de Find |
Expression for de comprimento zero ou Nothing, ou Start é maior que tamanho de Expression |
Nothing |
Count é 0. |
Cópia de Expression |
Exceções
Tipo de exceção |
Número de erro |
Condição |
|---|---|---|
Count< - 1 ou Start <= 0 . |
Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.
Comentários
O valor de retorno da função Replace é uma sequência de caracteres que começa na posição especificada por Start e termina no final da sequência de caracteresExpression , com as substituições feitas conforme especificado pelos valores Find e Replace.
Exemplo
Este exemplo demonstra a função Replace.
Dim TestString As String = "Shopping List"
' Returns "Shipping List".
Dim aString As String = Replace(TestString, "o", "i")
Requisitos
Namespace:Microsoft.VisualBasic
**Módulo:**Strings
Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)