Replace (Función, Visual Basic)

  • Artículo

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

Parámetros

  • 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.

Valores

El argumento Compare puede tener los siguientes valores:

Constante

Descripción

Binary

Realiza una comparación binaria

Text

Realiza una comparación textual

Valor devuelto

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

Excepciones

Tipo de excepción

Número de error

Condición

ArgumentException

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.

Comentarios

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.

Ejemplo

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")

Requisitos

Espacio de nombres:Microsoft.VisualBasic

**Módulo:**Strings

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

Vea también

Referencia

Resumen de manipulación de cadenas

Filter (Función, Visual Basic)

ArgumentException