Cadena multilineal en C# (Cómo funciona para desarrolladores)

¿Qué es una cadena multilínea?

Las cadenas multilínea son exactamente lo que parecen: una cadena que abarca múltiples líneas, en contraste con la cadena de una sola línea habitual. Una cadena multilínea en C# se crea utilizando literales de cadena, que son una serie de caracteres encerrados entre comillas dobles. Para formar cadenas multilínea, necesitamos usar un tipo especial de literales de cadena llamados literales de cadena verbatim.

La magia de las cadenas Verbatim

Para crear un literal de cadena multilínea en C#, usamos cadenas verbatim. Las cadenas textuales tienen como prefijo el símbolo @ y nos permiten incluir saltos de línea, caracteres especiales e incluso espacios en blanco sin utilizar secuencias de escape.

Aquí tienes un ejemplo de una cadena multilínea usando una cadena verbatim:

string str = @"This is a
multiline string
in C#.";

string str = @"This is a
multiline string
in C#.";

La cadena str contiene tres líneas y cada línea está separada por un salto de línea. Observe el uso del símbolo @ para crear la cadena textual.

string str = @"This is a
""multiline""
string in C#.";

string str = @"This is a
""multiline""
string in C#.";

Concatenar cadenas multilínea

A menudo, puede que necesites combinar cadenas multilínea con otras cadenas o valores. Para concatenar una cadena de varias líneas con otros valores de cadena, puede utilizar el operador +, tal como lo haría con cadenas de una sola línea.

string name = "John";
string str = @"Hello, " + name + @",
Welcome to the
world of C# multiline strings!";

string name = "John";
string str = @"Hello, " + name + @",
Welcome to the
world of C# multiline strings!";

Aquí, hemos concatenado la cadena de varias líneas con una cadena de una sola línea name.

Formateo de cadenas multilínea

Al trabajar con cadenas multilínea, puedes formatearlas con variables o expresiones. Para formatear una cadena de varias líneas, puede utilizar el símbolo $ para la interpolación de cadenas.

int age = 25;
string str = $@"Hello, I am {age} years old,
and I am learning
C# multiline strings!";

int age = 25;
string str = $@"Hello, I am {age} years old,
and I am learning
C# multiline strings!";

Utilizamos la interpolación de cadenas para incluir el valor de la variable age dentro de la cadena de varias líneas.

Conversión de cadenas multilínea a cadenas de una sola línea

A veces, puede que necesites convertir cadenas multilínea en cadenas de una sola línea. Para lograr esto, puede utilizar el método Replace para reemplazar los saltos de línea con un espacio o cualquier otro carácter deseado.

string multilineString = @"This is a
multiline string
in C#.";

string singleLineString = multilineString.Replace(Environment.NewLine, " ");

string multilineString = @"This is a
multiline string
in C#.";

string singleLineString = multilineString.Replace(Environment.NewLine, " ");

Reemplazamos los saltos de línea en la cadena multilínea con un espacio, resultando en una cadena de una sola línea.

Manejo de cadenas largas

A veces, las cadenas muy largas pueden ser difíciles de leer en tu código. Para que el código sea más legible, puede dividir cadenas largas en varias líneas utilizando el operador +.

string longString = "This is a very long string that " +
                    "needs to be split across " +
                    "multiple lines for better readability.";

string longString = "This is a very long string that " +
                    "needs to be split across " +
                    "multiple lines for better readability.";

Dividimos la cadena larga de una sola línea en tres partes y las concatenamos usando el operador +, haciendo que el código sea más legible.

Creación de literales de cadena multilínea con literales de cadena sin procesar

En C# 10, se introdujo una nueva característica llamada literales de cadena crudos. Estos nos permiten crear literales de cadena de varias líneas sin utilizar el símbolo @. Para crear un literal de cadena sin formato, encerramos la cadena entre comillas triples ("""). Los literales de cadena crudos preservan todos los caracteres, incluidos los saltos de línea, dentro de las comillas triples. Por ejemplo:

string str = """This is a
multiline string
using raw string literals in C# 10.""";

string str = """This is a
multiline string
using raw string literals in C# 10.""";

Creamos una cadena multilínea usando literales de cadena crudos. Observa el uso de comillas triples para encerrar la cadena.

string str = """This is a
""multiline""
string using raw string literals in C# 10.""";

string str = """This is a
""multiline""
string using raw string literals in C# 10.""";

string str = @"""This is a
multiline string
using both verbatim and raw string literals in C# 10.""";

string str = @"""This is a
multiline string
using both verbatim and raw string literals in C# 10.""";

Uso de cadenas multilínea para generar PDF en IronPDF

IronPDF es una biblioteca PDF .NET ligera diseñada específicamente pensando en los desarrolladores web. Hace que leer, escribir y manipular archivos PDF sea muy sencillo, capaz de convertir todo tipo de tipos de archivo en contenido PDF, y puedes usarlo en tus proyectos .NET tanto para escritorio como para la web. Lo mejor de todo - es gratis para probar en un entorno de desarrollo.

Aquí te mostramos cómo utilizar una cadena multilínea HTML para crear un archivo PDF en IronPDF:

string name = "John";
string age = "25";
string content = $@"<!DOCTYPE html>
<html>
<body>
<h1>Hello, {name}!</h1>
<p>You are {age} years old.</p>
<p>This is a
multiline string
used to generate a PDF
with IronPDF and dynamic content.</p>
</body>
</html>";

// Create a new PDF document using IronPDF
var pdfDocument = new IronPdf.ChromePdfRenderer();
pdfDocument.RenderHtmlAsPdf(content).SaveAs("c://BioData.pdf");

string name = "John";
string age = "25";
string content = $@"<!DOCTYPE html>
<html>
<body>
<h1>Hello, {name}!</h1>
<p>You are {age} years old.</p>
<p>This is a
multiline string
used to generate a PDF
with IronPDF and dynamic content.</p>
</body>
</html>";

// Create a new PDF document using IronPDF
var pdfDocument = new IronPdf.ChromePdfRenderer();
pdfDocument.RenderHtmlAsPdf(content).SaveAs("c://BioData.pdf");

En este ejemplo, utilizamos la interpolación de cadenas para incluir las variables name y age dentro de nuestra cadena de varias líneas, lo que hace que nuestro contenido PDF sea dinámico y personalizable. Creamos una cadena multilínea con el contenido que deseábamos en el PDF. Luego, instanciamos la clase ChromePdfRenderer del espacio de nombres IronPDF y usamos el método RenderHtmlAsPdf para convertir el contenido de la cadena de varias líneas en un documento PDF. Finalmente, guardamos el documento PDF en un archivo llamado "BioData.pdf".

Conclusión

Y eso es un rápido recorrido por el mundo versátil de las cadenas multilínea. Ahora que eres un experto en cadenas multilínea en C#, puedes comenzar a implementarlas en tus proyectos, como el ejemplo con IronPDF anterior.

¿Buscando poner tus manos en IronPDF? Puedes empezar con nuestra prueba gratuita de 30 días de IronPDF. También es completamente gratis para usar con fines de desarrollo, para que realmente puedas ver de qué está hecho. Y si te gusta lo que ves, IronPDF comienza desde tan solo $799 para una licencia IronPDF . Para ahorros aún mayores, echa un vistazo al paquete Iron Suite donde puedes obtener las nueve herramientas de Iron Software por el precio de dos. ¡Feliz programación!