AYUDA .NET

C# String Replace (Cómo funciona para desarrolladores)

Actualizado 16 de mayo, 2023
Compartir:

Tanto si es nuevo en programación como si sólo desea comprender mejor cómo manipular cadenas en C#, ha llegado al lugar adecuado. En este tutorial, exploraremos el método replace en C# utilizando ejemplos reales y relatos, para que resulte atractivo y fácil de seguir.

Conceptos básicos ¿Qué es una cadena?

Antes de sumergirnos en el método "string replace", exploremos primero los fundamentos de las cadenas. Una cadena es una secuencia de caracteres que puede incluir letras, números y símbolos. En C#, las cadenas se representan mediante el tipo de datos string. Son esenciales para manejar texto en un programa y vienen con una plétora de métodos incorporados para manipularlos. Uno de estos métodos es el de "reemplazar", en el que nos centraremos en este tutorial.

Introducción al método de sustitución

Imagina que estás escribiendo una aplicación que requiere que los usuarios introduzcan una frase. Su aplicación debe sustituir determinadas palabras o caracteres por otros nuevos. Aquí es donde resulta útil el método replace de C#.

El método replace es una función incorporada que permite sustituir todas las apariciones de un carácter Unicode o subcadena especificados por una nueva cadena. Digamos que tienes la siguiente cadena: "Me encanta el helado". Quiere sustituir la palabra "helado" por "chocolate" para crear una nueva cadena que diga: "Me encanta la crema de chocolate". El método replace hace que esta tarea sea fácil y eficaz.

Cómo utilizar el método de sustitución Guía paso a paso

Para utilizar el método de sustitución, siga estos sencillos pasos:

  1. Declarar una variable de cadena que contenga el texto original.
  2. Llama al método replace sobre la cadena especificada, proporcionando el carácter o subcadena a reemplazar y la nueva cadena.
  3. Almacena el resultado en una nueva variable de cadena o actualiza la cadena original.

    He aquí un ejemplo de código que demuestra estos pasos:

string originalText = "I love ice cream.";
string newText = originalText.Replace("ice", "chocolate");
Console.WriteLine(newText);
string originalText = "I love ice cream.";
string newText = originalText.Replace("ice", "chocolate");
Console.WriteLine(newText);
Dim originalText As String = "I love ice cream."
Dim newText As String = originalText.Replace("ice", "chocolate")
Console.WriteLine(newText)
VB   C#

Este fragmento de código mostraría la cadena modificada: "Me encanta la crema de chocolate".

Diferentes variantes del método de sustitución

En C#, existen dos versiones sobrecargadas del método replace para satisfacer diferentes necesidades. Veámoslos más de cerca:

Sustitución de un carácter Unicode especificado

La primera versión del método replace permite sustituir un carácter Unicode especificado por un nuevo carácter. La sintaxis de esta versión es:

public string Replace(char oldChar, char newChar);
public string Replace(char oldChar, char newChar);
public String Replace(Char oldChar, Char newChar)
VB   C#

He aquí un ejemplo que ilustra su uso:

string originalText = "H3ll0 W0rld!";
string newText = originalText.Replace('3', 'e');
newText = newText.Replace('0', 'o');
Console.WriteLine(newText);
string originalText = "H3ll0 W0rld!";
string newText = originalText.Replace('3', 'e');
newText = newText.Replace('0', 'o');
Console.WriteLine(newText);
Dim originalText As String = "H3ll0 W0rld!"
Dim newText As String = originalText.Replace("3"c, "e"c)
newText = newText.Replace("0"c, "o"c)
Console.WriteLine(newText)
VB   C#

La salida sería: "Hola Mundo!"

Sustitución de una subcadena

La segunda versión del método replace permite sustituir una subcadena especificada por una nueva cadena. La sintaxis de esta versión es:

public string Replace(string oldValue, string newValue);
public string Replace(string oldValue, string newValue);
public String Replace(String oldValue, String newValue)
VB   C#

He aquí un ejemplo que ilustra su uso:

string originalText = "I have a red car and a red hat.";
string newText = originalText.Replace("red", "blue");
Console.WriteLine(newText);
string originalText = "I have a red car and a red hat.";
string newText = originalText.Replace("red", "blue");
Console.WriteLine(newText);
Dim originalText As String = "I have a red car and a red hat."
Dim newText As String = originalText.Replace("red", "blue")
Console.WriteLine(newText)
VB   C#

La salida sería: "Tengo un coche azul y un sombrero azul".

Sensibilidad a mayúsculas y minúsculas y método de sustitución

Es importante tener en cuenta que el método de sustitución distingue entre mayúsculas y minúsculas. Esto significa que si está intentando reemplazar un carácter Unicode especificado o una subcadena, las mayúsculas y minúsculas deben coincidir exactamente. Por ejemplo, considere el siguiente fragmento de código:

string originalText = "Cats are great pets, but some people prefer CATS.";
string newText = originalText.Replace("CATS", "dogs");
Console.WriteLine(newText);
string originalText = "Cats are great pets, but some people prefer CATS.";
string newText = originalText.Replace("CATS", "dogs");
Console.WriteLine(newText);
Dim originalText As String = "Cats are great pets, but some people prefer CATS."
Dim newText As String = originalText.Replace("CATS", "dogs")
Console.WriteLine(newText)
VB   C#

El resultado sería: "Los gatos son buenas mascotas, pero algunas personas prefieren los perros".

Observe que sólo se ha sustituido la mayúscula "CATS", mientras que la minúscula "Cats" no ha cambiado. Si desea realizar una sustitución sin distinguir entre mayúsculas y minúsculas, tendrá que convertir la cadena original y la cadena de búsqueda a un formato común (superior o inferior) y, a continuación, realice la sustitución. He aquí un ejemplo:

string originalText = "Cats are great pets, but some people prefer CATS.";
string lowerCaseText = originalText.ToLower();
string newText = lowerCaseText.Replace("cats", "dogs");
Console.WriteLine(newText);
string originalText = "Cats are great pets, but some people prefer CATS.";
string lowerCaseText = originalText.ToLower();
string newText = lowerCaseText.Replace("cats", "dogs");
Console.WriteLine(newText);
Dim originalText As String = "Cats are great pets, but some people prefer CATS."
Dim lowerCaseText As String = originalText.ToLower()
Dim newText As String = lowerCaseText.Replace("cats", "dogs")
Console.WriteLine(newText)
VB   C#

El resultado sería: "los perros son grandes mascotas, pero algunas personas prefieren a los perros".

Tenga en cuenta que este enfoque también cambiará la carcasa de toda la cadena. Si desea conservar las mayúsculas y minúsculas originales, puede utilizar el método Regex.Replace con la opción RegexOptions.IgnoreCase.

El poder de encadenar métodos de sustitución

También puede encadenar varios métodos de sustitución para realizar varias sustituciones en una sola línea de código. Esto resulta especialmente útil cuando es necesario sustituir varios caracteres o subcadenas por nuevas cadenas diferentes. He aquí un ejemplo:

string originalText = "H3ll0 W0rld!";
string newText = originalText.Replace('3', 'e').Replace('0', 'o');
Console.WriteLine(newText);
string originalText = "H3ll0 W0rld!";
string newText = originalText.Replace('3', 'e').Replace('0', 'o');
Console.WriteLine(newText);
Dim originalText As String = "H3ll0 W0rld!"
Dim newText As String = originalText.Replace("3"c, "e"c).Replace("0"c, "o"c)
Console.WriteLine(newText)
VB   C#

La salida sería: "Hola Mundo!"

En este ejemplo, hemos sustituido "3" por "e" y "0" por "o" con una sola línea de código.

Expresiones regulares y el método Replace

Mientras que el método replace es perfecto para reemplazos simples de cadenas, puede que necesites una funcionalidad más avanzada para escenarios complejos. En estos casos, puede utilizar expresiones regulares y el método Regex.Replace para realizar manipulaciones avanzadas de cadenas.

El método Regex.Replace permite buscar un patrón en la cadena original y sustituirlo por su valor en una nueva cadena. Puede utilizar expresiones regulares para hacer coincidir patrones, especificar opciones como la insensibilidad a mayúsculas y minúsculas e incluso utilizar grupos de captura para realizar sustituciones dinámicas.

He aquí un ejemplo de uso del método Regex.Replace para reemplazar todas las apariciones de un patrón por una nueva cadena vacía:

using System.Text.RegularExpressions;

string originalText = "100 cats, 25 dogs, and 50 birds.";
string pattern = @"\d+";
string newText = Regex.Replace(originalText, pattern, "many");
Console.WriteLine(newText);
using System.Text.RegularExpressions;

string originalText = "100 cats, 25 dogs, and 50 birds.";
string pattern = @"\d+";
string newText = Regex.Replace(originalText, pattern, "many");
Console.WriteLine(newText);
Imports System.Text.RegularExpressions

Private originalText As String = "100 cats, 25 dogs, and 50 birds."
Private pattern As String = "\d+"
Private newText As String = Regex.Replace(originalText, pattern, "many")
Console.WriteLine(newText)
VB   C#

La salida sería: "muchos gatos, muchos perros y muchos pájaros".

En este ejemplo, hemos utilizado el patrón de expresión regular \d+ para que coincida con cualquier secuencia de uno o más dígitos y los hemos sustituido por la palabra "muchos".

IronPDF: Generación de PDF con sustitución de cadenas en C#

Puede aprovechar las potentes funciones de IronPDF HTML a PDF junto con el método de sustitución de cadenas de C# para crear documentos PDF dinámicos.

using IronPdf;

class Program
{
    static void Main(string [] args)
    {
        var renderer = new ChromePdfRenderer();

        //  1. Convertir cadena HTML a PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        //  2. Convertir archivo HTML a PDF
        var htmlFilePath = "path_to_your_html_file.html"; //  Especifique la ruta a su archivo HTML
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        //  3. Convertir URL a PDF
        var url = "http://ironpdf.com"; // Especificar la URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}
using IronPdf;

class Program
{
    static void Main(string [] args)
    {
        var renderer = new ChromePdfRenderer();

        //  1. Convertir cadena HTML a PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        //  2. Convertir archivo HTML a PDF
        var htmlFilePath = "path_to_your_html_file.html"; //  Especifique la ruta a su archivo HTML
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        //  3. Convertir URL a PDF
        var url = "http://ironpdf.com"; // Especificar la URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}
Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

		'  1. Convertir cadena HTML a PDF
		Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"
		Dim pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent)
		pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf")

		'  2. Convertir archivo HTML a PDF
		Dim htmlFilePath = "path_to_your_html_file.html" '  Especifique la ruta a su archivo HTML
		Dim pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath)
		pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf")

		'  3. Convertir URL a PDF
		Dim url = "http://ironpdf.com" ' Especificar la URL
		Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
		pdfFromUrl.SaveAs("URLToPDF.pdf")
	End Sub
End Class
VB   C#

Primeros pasos con IronPDF

Para empezar a utilizar IronPDF Primero tendrá que instalar el paquete NuGet de IronPDF. Para ello, ejecute el siguiente comando en la consola del gestor de paquetes:

Install-Package IronPdf

También puede buscar "IronPDF" en el gestor de paquetes NuGet de Visual Studio e instalarlo desde allí.

Creación de un PDF con sustitución de cadenas

Supongamos que desea crear un Informe PDF a partir de HTML que muestra saludos personalizados para diferentes usuarios. Puede utilizar el método de sustitución de cadenas de C# para sustituir los marcadores de posición de una plantilla HTML por los datos reales del usuario y, a continuación, utilizar IronPDF para convertir el HTML en un documento PDF.

Aquí tienes una guía paso a paso sobre cómo hacerlo:

Cree una plantilla HTML con marcadores de posición para los datos del usuario.


Personalized Greeting

Hello, {USERNAME}!
    Welcome to our platform. Your email address is {EMAIL}.

Utilice el método C# string replace para sustituir la cadena actual y los marcadores de posición por los datos reales del usuario.

string htmlTemplate = File.ReadAllText("greeting_template.html");
string personalizedHtml = htmlTemplate.Replace("{USERNAME}", "John Doe")
                                        .Replace("{EMAIL}", "john.doe@example.com");
string htmlTemplate = File.ReadAllText("greeting_template.html");
string personalizedHtml = htmlTemplate.Replace("{USERNAME}", "John Doe")
                                        .Replace("{EMAIL}", "john.doe@example.com");
Dim htmlTemplate As String = File.ReadAllText("greeting_template.html")
Dim personalizedHtml As String = htmlTemplate.Replace("{USERNAME}", "John Doe").Replace("{EMAIL}", "john.doe@example.com")
VB   C#

Utilice IronPDF para convertir el HTML personalizado en un documento PDF.

using IronPdf;

var renderer = new IronPDF.ChromePdfRenderer();
PdfDocument pdfDocument = renderer.RenderHtmlAsPdf(personalizedHtml);
using IronPdf;

var renderer = new IronPDF.ChromePdfRenderer();
PdfDocument pdfDocument = renderer.RenderHtmlAsPdf(personalizedHtml);
Imports IronPdf

Private renderer = New IronPDF.ChromePdfRenderer()
Private pdfDocument As PdfDocument = renderer.RenderHtmlAsPdf(personalizedHtml)
VB   C#

Guarde el documento PDF en un archivo o transmítalo al usuario.

pdfDocument.SaveAs("PersonalizedGreeting.PDF");
pdfDocument.SaveAs("PersonalizedGreeting.PDF");
pdfDocument.SaveAs("PersonalizedGreeting.PDF")
VB   C#

C# Reemplazar cadena (Cómo funciona para desarrolladores) Figura 1 - Salida

Y eso es todo.! Ha creado con éxito un documento PDF personalizado utilizando el método replace de C# y IronPDF.

Conclusión

Combinando la potencia de IronPDF con la flexibilidad del método replace de C#, puede crear documentos PDF dinámicos adaptados a usuarios o escenarios específicos. Este enfoque no sólo se limita a las felicitaciones personalizadas: puede utilizarlo para generar facturas, informes, certificados y mucho más.

IronPDF ofrece un prueba gratuita que le permite explorar sus posibilidades sin ninguna inversión inicial. Si considera que se adapta perfectamente a sus necesidades de generación de PDF, la licencia comienza a partir de $749.

< ANTERIOR
Bucle For en C# (Cómo funciona para desarrolladores)
SIGUIENTE >
C# para cada uno (Cómo funcionan las TI para desarrolladores)

¿Listo para empezar? Versión: 2024.6 recién publicada

Comenzar prueba gratuita Descargas totales: 9,602,420
Ver licencias >