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 verbatim se prefijan con el símbolo @ y nos permiten incluir saltos de línea, caracteres especiales e incluso espacios en blanco sin usar 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#.";

Dim str As String = "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. Observa el uso del símbolo @ para crear la cadena verbatim.

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

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

Dim str As String = "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 multilínea con otros valores de cadena, puedes usar el operador +, al igual que harías 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!";

Dim name As String = "John"
Dim str As String = "Hello, " & name & ",
Welcome to the
world of C# multiline strings!"

Aquí, hemos concatenado la cadena multilínea 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 multilínea, puedes usar 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!";

Dim age As Integer = 25
Dim str As String = $"Hello, I am {age} years old,
and I am learning
C# multiline strings!"

Usamos la interpolación de cadenas para incluir el valor de la variable age dentro de la cadena multilínea.

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, puedes usar 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, " ");

Dim multilineString As String = "This is a
multiline string
in C#."

Dim singleLineString As String = 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 hacer el código más legible, puedes dividir las cadenas largas en múltiples líneas usando 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.";

Dim longString As String = "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 multilínea sin usar el símbolo @. Para crear un literal de cadena crudo, 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.""";

Dim str As String = """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.""";

Dim str As String = """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.""";

Dim str As String = """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");

Dim name As String = "John"
Dim age As String = "25"
Dim content As String = $"<!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
Dim pdfDocument = New IronPdf.ChromePdfRenderer()
pdfDocument.RenderHtmlAsPdf(content).SaveAs("c://BioData.pdf")

En este ejemplo, usamos la interpolación de cadenas para incluir las variables name y age dentro de nuestra cadena multilínea, haciendo 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 multilínea 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 tan bajo como $799 para una licencia de 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!