C# Multiline String (jak to działa dla programistów)

Czym jest ciąg wielowierszowy?

Ciągi wielowierszowe są dokładnie tym, na co wskazuje ich nazwa — ciągami obejmującymi wiele wierszy, w przeciwieństwie do zwykłych ciągów jednowierszowych. Wielowierszowy ciąg znaków w języku C# tworzy się za pomocą literałów łańcuchowych, które są serią znaków ujętych w podwójne cudzysłowy. Aby utworzyć ciągi wielowierszowe, musimy użyć specjalnego typu literałów łańcuchowych zwanych literałami łańcuchowymi verbatim.

Magia ciągów znaków Verbatim

Aby utworzyć wielowierszowy literał łańcuchowy w języku C#, używamy łańcuchów dosłownych. Stringi doslowne sa poprzedzone symbolem @ i pozwalaja na wlaczenie zlaman linii, znakow specjalnych, a nawet bialych znakow bez uzycia sekwencji ucieczki.

Oto przykład wielowierszowego ciągu znaków wykorzystującego ciąg dosłowny:

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#."

String str zawiera trzy linie, a kazda linia jest oddzielona zlamiem linii. Zauwaz uzycie symbolu @ do stworzenia stringu doslownego.

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#."

Łączenie ciągów wielowierszowych

Często może zaistnieć potrzeba połączenia ciągów wielowierszowych z innymi ciągami lub wartościami. Aby polaczyc string multiliniowy z innymi wartosciami stringowymi, mozna uzyc operatora +, tak jak w przypadku stringow jednoliniowych.

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!"

Tutaj, polaczylismy string multiliniowy ze stringiem jednoliniowym name.

Formatowanie ciągów wielowierszowych

W przypadku pracy z ciągami wielowierszowymi można je formatować za pomocą zmiennych lub wyrażeń. Aby sformatowac string multiliniowy, mozna uzyc symbolu $ do interpolacji stringu.

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!"

Uzyto interpolacji stringu, aby wlaczyc wartosc zmiennej age do stringu multiliniowego.

Konwersja ciągów wielowierszowych na ciągi jednowierszowe

Czasami moze zajsc potrzeba konwersji wielowierszowych lancuchow znakow na jednoliniowe. Aby to osiagnac, mozna uzyc metody Replace do zamiany zlaman linii na spacje lub inny pozadany znak.

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, " ")

Zastapilismy zlamania linii w wielowierszowym lancuchu znakow spacja, co dalo wynik w postaci jednoliniowego lancucha znakow.

Obsługa długich ciągów znaków

Czasami bardzo dlugie lancuchy znakow moga byc trudne do odczytania w kodzie. Aby uczynic kod bardziej czytelnym, mozna podzielic dlugie stringi na wiele linii uzywajac operatora +.

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."

Podzielilismy dlugi string jednoliniowy na trzy czesci i polaczylismy je za pomoca operatora +, czyniac kod bardziej czytelnym.

Tworzenie wielowierszowych literałów łańcuchowych za pomocą literałów łańcuchowych typu raw

W C# 10 wprowadzono nową funkcję o nazwie literały ciągów surowych. To pozwala na tworzenie doslownych stringow multiliniowych bez uzycia symbolu @. Aby stworzyc doslowny string surowy, obejmujemy string potrojnymi cudzyslowami ("""). Literale łańcuchów surowych zachowują wszystkie znaki, w tym znaki końca linii, w potrójnych cudzysłowach. Na przykład:

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."""

Stworzyliśmy ciąg wielowierszowy przy użyciu literałów ciągu surowego. Zwróć uwagę na użycie potrójnych cudzysłowów do ujęcia ciągu znaków.

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."""

Wykorzystanie ciągów wielowierszowych do generowania plików PDF w IronPDF

IronPDF to lekka biblioteka .NET do obsługi plików PDF, zaprojektowana specjalnie z myślą o programistach stron internetowych. Dzięki temu czytanie, pisanie i edycja plików PDF staje się dziecinnie prosta, umożliwia konwersję wszelkiego rodzaju plików do formatu PDF, a ponadto można z niego korzystać w projektach .NET zarówno na komputery stacjonarne, jak i w sieci. Najlepsze jest to, że można wypróbować to rozwiązanie w środowisku programistycznym za darmo.

Oto jak wykorzystać wielowierszowy ciąg znaków HTML do utworzenia pliku PDF w 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")

W tym przykladzie uzylismy interpolacji stringu, aby wlaczyc zmienne name i age do naszego stringu multiliniowego, czyniac nasza zawartosc PDF dynamiczna i dostosowywana. Stworzyliśmy wielowierszowy ciąg znaków zawierający treść, którą chcieliśmy umieścić w pliku PDF. Nastepnie zainstancjonowano klase ChromePdfRenderer z przestrzeni nazw IronPDF i uzyto metody RenderHtmlAsPdf do konwersji zawartosci stringu multiliniowego na dokument PDF. Na koniec zapisaliśmy dokument PDF w pliku o nazwie "BioData.pdf".

Wnioski

To była krótka wycieczka po wszechstronnym świecie ciągów wielowierszowych. Teraz, gdy jesteś już profesjonalistą w zakresie ciągów wielowierszowych w języku C#, możesz zacząć wdrażać je w swoich projektach — na przykład tak, jak w powyższym przykładzie z IronPDF.

Chcesz wypróbować IronPDF? Możesz zacząć od 30-dniowego okresu próbnego IronPDF. Można z niego korzystać całkowicie za darmo do celów programistycznych, więc naprawdę możesz sprawdzić, na czym to polega. A jezeli podoba ci sie to, co widzisz, IronPDF zaczyna sie juz od $999 za licencje IronPDF. Aby uzyskać jeszcze większe oszczędności, sprawdź pakiet Iron Suite, w którym możesz otrzymać wszystkie dziewięć narzędzi Iron Software w cenie dwóch. Miłego kodowania!