Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método String.Replace (String, String)

 

Publicado: octubre de 2016

Devuelve una nueva cadena en la que todas las apariciones de una cadena especificada en la instancia actual se reemplazan por otra cadena especificada.

Espacio de nombres:   System
Ensamblado:  mscorlib (en mscorlib.dll)

public string Replace(
	string oldValue,
	string newValue
)

Parámetros

oldValue
Type: System.String

Cadena que se va a reemplazar.

newValue
Type: System.String

Cadena que va a reemplazar todas las apariciones de oldValue.

Valor devuelto

Type: System.String

Cadena que es equivalente a la cadena actual salvo en que todas las instancias de oldValue se reemplacen por newValue. Si oldValue no se encuentra en la instancia actual, el método devuelve la instancia actual sin modificar.

Exception Condition
ArgumentNullException

El valor de oldValue es null.

ArgumentException

oldValue es la cadena vacía ("").

Si newValue es null, todas las apariciones de oldValue se quitan.

System_CAPS_noteNota

Este método no modifica el valor de la instancia actual. En su lugar, devuelve una nueva cadena en la que todas las apariciones de oldValue se ha reemplazado por newValue.

Este método realiza una búsqueda ordinal (distingue mayúsculas de minúsculas y la referencia cultural) para buscar oldValue.

Dado que este método devuelve la cadena modificada, puede encadenar llamadas sucesivas a la Replace método para realizar reemplazos varios en la cadena original. Llamadas a métodos se ejecutan de izquierda a derecha. Esto se muestra en el ejemplo siguiente.

using System;

public class Example
{
   public static void Main()
   {
      String s = "aaa";
      Console.WriteLine("The initial string: '{0}'", s);
      s = s.Replace("a", "b").Replace("b", "c").Replace("c", "d");
      Console.WriteLine("The final string: '{0}'", s);
   }
}
// The example displays the following output:
//       The initial string: 'aaa'
//       The final string: 'ddd'

En el ejemplo siguiente se muestra cómo se puede utilizar el Replace método para corregir un error ortográfico.

using System;

public class ReplaceTest {
    public static void Main() {

        string errString = "This docment uses 3 other docments to docment the docmentation";

        Console.WriteLine("The original string is:{0}'{1}'{0}", Environment.NewLine, errString);

        // Correct the spelling of "document".

        string correctString = errString.Replace("docment", "document");

        Console.WriteLine("After correcting the string, the result is:{0}'{1}'",
                Environment.NewLine, correctString);
    }
}
//
// This code example produces the following output:
//
// The original string is:
// 'This docment uses 3 other docments to docment the docmentation'
//
// After correcting the string, the result is:
// 'This document uses 3 other documents to document the documentation'
//

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: