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

Referência

Definição

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Origem:: Strings.vb

Origem:: Strings.vb

Origem:: Strings.vb

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

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

Aplica-se a

Compartilhar via