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

Definición

Espacio de nombres:

Microsoft.VisualBasic

Ensamblado:

Microsoft.VisualBasic.Core.dll

Source:

Strings.vb

Devuelve una cadena en la que la subcadena especificada se reemplaza determinado número de veces por otra subcadena.

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

Obligatorio. Expresión de cadena que contiene la subcadena que se va a reemplazar.

Find

String

Obligatorio. Subcadena que se va a buscar.

Replacement

String

Obligatorio. Subcadena de reemplazo.

Start

Int32

Opcional. Posición dentro de Expression que inicia una subcadena usada para el reemplazo. El valor devuelto de Replace es una cadena que comienza en Start, con substituciones adecuadas. Si se omite, se supone que el valor es 1.

Count

Int32

Opcional. Número de reemplazos de subcadena que se van a realizar. Si se omite, el valor predeterminado es -1, lo que significa que se van a realizar todos los reemplazos posibles.

Compare

CompareMethod

Opcional. Valor numérico que indica el tipo de comparación que se va a utilizar al evaluar subcadenas. Para obtener los valores, vea Configuración.

Devoluciones

String

Uno de los siguientes valores.

Si	Replace devolverá:
Find es de longitud cero o Nothing	Copia de Expression
Replace tiene longitud cero	Copia de Expression sin apariciones de Find
Expression es de longitud cero o Nothing, o bien Start es mayor que la longitud de Expression	Nothing
Count es igual a 0,	Copia de Expression

Excepciones

ArgumentException

Count< -1 o Start<= 0.

Ejemplos

En este ejemplo se muestra la Replace función .

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

Comentarios

El valor devuelto de la Replace función es una cadena que comienza en la posición especificada por Start y concluye al final de la Expression cadena, con las sustituciones realizadas según lo especificado por los Find valores y Replace .

El Compare argumento puede tener los valores siguientes.

Constante	Descripción
Binary	Realiza una comparación binaria
Text	Realiza una comparación textual

Consulte también

• Filter
• ArgumentException
• Resumen de la manipulación de cadenas