C# | Método Reemplazar()

En C#, el método Reemplazar() es un método de string. Este método se usa para reemplazar todos los caracteres Unicode especificados o la string especificada del objeto de string actual y devuelve una nueva string modificada. Este método se puede sobrecargar pasándole argumentos.

Sintaxis:

public string Replace(char Oldchar, char Newchar)
or
public string Replace(string Oldvalue, string Newvalue)

Explicación:
el primer método toma dos parámetros, Oldchar y Newchar, donde Oldchar es el carácter Unicode que se reemplazará y Newchar es el carácter que reemplazará todas las apariciones de OldChar.
El segundo método también toma dos parámetros Oldvalue y Newvalue donde Oldvalue es la string que se reemplazará y Newvalue es una string para reemplazar todas las apariciones de Oldvalue. El valor de tipo de retorno de ambos métodos es System.String .

Excepciones:

• ArgumentNullException : si OldValue o Oldchar son nulos.
• ArgumentException Si OldValue o Oldchar es la string vacía («»).

A continuación se muestran los programas para demostrar los métodos anteriores:

• Ejemplo 1: programa para demostrar el método de sustitución de string pública (char Oldchar, char Newchar) . Todas las apariciones de un carácter específico se reemplazan con otro carácter específico. Si oldChar no se encuentra en el objeto de string actual, la string permanece sin cambios.

  Input : str  = "GeeksForGeeks"
          str.Replace('s', 'G');
  Output: GeekGForGeekG
  
  Input : str  = "GeeksForGeeks"
          str.Replace('e', ' ');
  Output: G  ksForG  ks
  

  // C# program to illustrate the Replace() // Method with character parameter using System;    class Geeks {        // Main Method     public static void Main()     {            // string         String str = "Geeks For Geeks";            Console.WriteLine("OldString : " + str);            // replace the character 's' with 'G'         Console.WriteLine("NewString: " + str.Replace('s', 'G'));            // oldString will remain unchanged         // its return the modified string         Console.WriteLine("\nOldString: " + str);            // replace the character 'e' with space ' '         Console.WriteLine("NewString: " + str.Replace('e', ' '));     } }

  Producción:

  OldString : Geeks For Geeks
  NewString: GeekG For GeekG
  
  OldString: Geeks For Geeks
  NewString: G  ks For G  ks
  

• Ejemplo 2: programa para demostrar el método de sustitución de string pública (string Oldvalue, string Newvalue) . Todas las apariciones de una string especificada en la instancia de string actual se reemplazan con otra string especificada. Si Oldvalue no se encuentra en la string actual, la string permanece sin cambios.

  Input:  str  = "Geeks For Geeks"
          str.Replace("Geeks", "---");
  Output: --- For ---
  
  Input:  str  = "Geeks For Geeks"
          str.Replace("For", "GFG");
  Output: Geeks GFG Geeks
  

  // C# program to illustrate the Replace // Method with string parameter using System;    class Geeks {        // Main Method     public static void Main()     {            // define string         String str = "Geeks For Geeks";            Console.WriteLine("OldString : " + str);            // replace the string 'Geeks' with '---'         // in string 'Geeks comes two time so replace two times         Console.WriteLine("NewString: " + str.Replace("Geeks", "---"));            // oldString will remain unchanged         // its return the modified string         Console.WriteLine("\nOldString: " + str);            // replace the string 'For' with 'GFG'         Console.WriteLine("NewString: " + str.Replace("For", "GFG"));     } }

  Producción:

  OldString : Geeks For Geeks
  NewString: --- For ---
  
  OldString: Geeks For Geeks
  NewString: Geeks GFG Geeks
  

Para realizar múltiples operaciones de reemplazo en la string (String de reemplazo):

El método Reemplazar() anterior devuelve la string modificada, por lo que ahora podemos enstringr llamadas sucesivas al método Reemplazar para realizar múltiples reemplazos en la string. Las llamadas a métodos se ejecutan de izquierda a derecha.
En el siguiente ejemplo, para la string dada «XXXXX», primero X se reemplazará con Y y luego Y se reemplazará con Z y, finalmente, Z se reemplazará con A.

Ejemplo :

// C# program to demonstrate the 
// multiple replacements calls
using System;
  
public class Geeks{
  
    // Main Method
    public static void Main()
    {
        String str = "XXXXX";
        Console.WriteLine("Old String: " + str);
  
        // chain together
        str = str.Replace('X', 'Y').Replace('Y', 'Z').Replace('Z', 'A');
        Console.WriteLine("New string: " + str);
    }
}

Old String: XXXXX
New string: AAAAA

Puntos importantes para recordar:

• El método Replace() no modifica el valor de la instancia actual. En su lugar, devuelve una nueva string en la que todas las apariciones de Oldvalue se reemplazan por Newvalue, de manera similar, oldchar se reemplaza por Newchar.
• Realiza una búsqueda que distingue entre mayúsculas y minúsculas para encontrar OldValue o Oldchar. Si Newvalue es nulo, se eliminan todas las apariciones de Oldvalue.

Referencias:

• https://msdn.microsoft.com/en-us/library/czx8s9ts(v=vs.110).aspx
• https://msdn.microsoft.com/en-us/library/fk49wtc1(v=vs.110).aspx