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

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.dll

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

Required. Expressão de cadeia que contém subcadeia para substituir.

Find

String

Required. Subcadeia a ser procurada.

Replacement

String

Required. Subcadeia de substituição.

Start

Int32

Optional. Posição dentro Expression disso inicia uma subcadeia de caracteres usada para substituição. O valor retornado é uma cadeia de Replace caracteres que começa em Start, com substituições apropriadas. Se omitido, é assumido 1.

Count

Int32

Optional. Número de substituições de subcadeia a executar. Se omitido, o valor padrão será -1, o que significa "fazer todas as substituições possíveis".

Compare

CompareMethod

Optional. Valor numérico que indica o tipo de comparação a utilizar ao avaliar subcadeias. Consulte Configurações para obter valores.

Retornos

String

Um dos valores a seguir.

Se	Replace retorna
Find tem comprimento zero ou Nothing	Cópia de Expression
Replace é de comprimento zero	Cópia sem Expression ocorrências de Find
Expression é de 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 Start e termina no final da cadeia de Expression caracteres, com as substituições feitas conforme especificado pelos Find valores e Replace valores.

O Compare argumento pode ter os seguintes valores.

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

Confira também

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