Partilhar via


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

Definição

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

Um dos valores a seguir.

IfA 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 ExpressionNothing
Count é 0 Cópia de Expression

Exceções

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

Aplica-se a

Confira também