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

Definição

Espaço de Nomes:
Microsoft.VisualBasic
Assemblagem:
Microsoft.VisualBasic.dll

Devolve uma cadeia em que uma subcadeia especificada foi substituída por outra subcadeia 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. A posição dentro Expression disso inicia uma subcorda usada para substituição. O valor de retorno de Replace é uma cadeia 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 é -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 Definições para valores.

Devoluções

String

Um dos seguintes valores.

SeSubstituir retornos
Find é de comprimento zero ou Nothing Cópia de Expression
Replace é de comprimento zero Cópia de Expression sem ocorrências de Find
Expression é de comprimento zero ou Nothing, ou Start é maior que o comprimento de ExpressionNothing
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")

Observações

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

O Compare argumento pode ter os seguintes valores.

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

Aplica-se a

Ver também