Strings.Replace(String, String, String, Int32, Int32, CompareMethod) Método

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

Strings.vb

Retorna uma cadeia de caracteres na qual uma subcadeia de caracteres especificada foi substituída por outra subcadeia de caracteres um número especificado de vezes.

public static string? Replace (string? Expression, string? Find, string? Replacement, int Start = 1, int Count = -1, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);

static member Replace : string * string * string * int * int * Microsoft.VisualBasic.CompareMethod -> string

Public Function Replace (Expression As String, Find As String, Replacement As String, Optional Start As Integer = 1, Optional Count As Integer = -1, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As String

Parâmetros

Expression

String

Obrigatórios. A expressão de cadeia de caracteres que contém a subcadeia de caracteres a ser substituída.

Find

String

Obrigatórios. A subcadeia de caracteres que está sendo pesquisada.

Replacement

String

Obrigatórios. Subcadeia de caracteres de substituição.

Start

Int32

Opcional. Posicione dentro da Expression que inicia uma subcadeia de caracteres usada para a substituição. O valor retornado de Replace é uma cadeia de caracteres que começa em Start, com as substituições apropriadas. Caso omitido, 1 é pressuposto.

Count

Int32

Opcional. Número de substituições de subcadeias de caracteres a ser executado. Caso seja omitido, o valor padrão será -1, o que significa "realizar todas as substituições possíveis".

Compare

CompareMethod

Opcional. Valor numérico que indica o tipo de comparação a ser usado ao avaliar subcadeias de caracteres. Consulte Configurações para obter os valores.

Retornos

String

Um dos valores a seguir.

If	A substituição 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 tem comprimento zero ou Nothing ou Start é maior que o comprimento de Expression	Nothing
Count é 0	Cópia de Expression

Exceções

ArgumentException

Count< -1 ou Start<= 0.

Exemplos

Este exemplo demonstra a Replace função .

Dim TestString As String = "Shopping List"  
' Returns "Shipping List".  
Dim aString As String = Replace(TestString, "o", "i")  

Comentários

O valor retornado da Replace função é uma cadeia de caracteres que começa na posição especificada por Start e termina no final da cadeia de Expression caracteres, com as substituições feitas conforme especificado pelos Find valores e Replace .

O Compare argumento pode ter os valores a seguir.

Constante	Descrição
Binary	Executa uma comparação binária
Text	Executa uma comparação textual

Confira também

• Filter
• ArgumentException
• Resumo de manipulação da cadeia de caracteres