Compartilhar via


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

ArgumentException

5

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)

Consulte também

Referência

Sumário de Manipulação de Strings

Filtrar função (Visual Basic)

ArgumentException