Replace (Función, Visual Basic)

Actualización: noviembre 2007

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


Public Function Replace(
   ByVal Expression As String,
   ByVal Find As String,
   ByVal Replacement As String,
   Optional ByVal Start As Integer = 1,
   Optional ByVal Count As Integer = -1,
   Optional ByVal Compare As CompareMethod = CompareMethod.Binary
) As String

Expression

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

Find

Requerido. Subcadena que se busca.

Replacement

Requerido. Subcadena de reemplazo.

Start

Opcional. Posición, dentro de Expression, donde debe empezar la búsqueda de la subcadena. Si se omite, se supone que es 1.

Count

Opcional. Número de sustituciones de subcadenas que se deben realizar. Si se omite, el valor predeterminado será –1, con lo que se harán todas las sustituciones posibles.

Compare

Opcional. Valor numérico que indica el tipo de comparación que se va a utilizar en la evaluación de subcadenas. Vea la sección Configuración para conocer los valores utilizados.

El argumento Compare puede tener los siguientes valores:

Constante

Descripción

Binary

Realiza una comparación binaria

Text

Realiza una comparación textual

Replace devuelve los siguientes valores.

Si

Replace devolverá:

Findes de longitud cero oNothing

Una copia de Expression

Replace tiene longitud cero

Una 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,

Una copia de Expression

Tipo de excepción

Número de error

Condición

ArgumentException

https://msdn.microsoft.com/es-es/library/h7ye15z8(v=vs.90)

Count < -1 ó Start <= 0.

Consulte la columna "Número de error" si está actualizando aplicaciones de Visual Basic 6.0 que utilizan el control de errores no estructurado. (Se puede comparar el número de error con respecto a Number (Propiedad, objeto Err)). Sin embargo, siempre que sea posible, se debe considerar la sustitución de dicho control de errores por Información general sobre el control estructurado de excepciones de Visual Basic.

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

En este ejemplo se muestra el uso de la función Replace.

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

Espacio de nombres:Microsoft.VisualBasic

Módulo:Strings

Ensamblado:Visual Basic Runtime Library (en Microsoft.VisualBasic.dll)

Adiciones de comunidad

Mostrar: