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. Ciągi tekstowe pozostawione bez zmian są poprzedzone symbolem @ i pozwalają nam na umieszczanie znaków końca linii, znaków specjalnych, a nawet spacji bez użycia sekwencji escape.

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

Ciąg znaków str zawiera trzy wiersze, a każdy wiersz jest oddzielony znakiem końca wiersza. Zwróć uwagę na użycie symbolu @ w celu utworzenia ciągu znaków dosłownego.

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 połączyć ciąg wielowierszowy z innymi wartościami ciągu, można użyć operatora +, tak samo jak w przypadku ciągów jednowierszowych.

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

W tym miejscu połączyliśmy ciąg wielowierszowy z ciągiem jednowierszowym name.

Formatowanie ciągów wielowierszowych

W przypadku pracy z ciągami wielowierszowymi można je formatować za pomocą zmiennych lub wyrażeń. Aby sformatować ciąg wielowierszowy, można użyć symbolu $ do interpolacji ciągów.

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

Użyliśmy interpolacji ciągów znaków, aby umieścić wartość zmiennej age w ciągu wielowierszowym.

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

Czasami może zaistnieć potrzeba przekształcenia ciągów wielowierszowych w ciągi jednowierszowe. Aby to osiągnąć, można użyć metody Replace do zastąpienia znaków końca linii spacją lub innym wybranym znakiem.

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

Zastąpiliśmy znaki końca linii w ciągu wielowierszowym spacją, uzyskując w ten sposób ciąg jednowierszowy.

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

Czasami bardzo długie ciągi znaków mogą być trudne do odczytania w kodzie. Aby kod był bardziej czytelny, długie ciągi znaków można podzielić na wiele wierszy za pomocą 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."

Podzieliliśmy długi ciąg znaków w jednej linii na trzy części i połączyliśmy je za pomocą operatora +, dzięki czemu kod stał się bardziej czytelny.

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. Pozwalają one na tworzenie wielowierszowych literałów łańcuchowych bez użycia symbolu @. Aby utworzyć literał ciągu znaków w postaci surowej, umieszczamy ciąg znaków w potrójnych cudzysłowach ("""). 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 przykładzie użyliśmy interpolacji ciągów znaków, aby umieścić zmienne name i age w naszym wielowierszowym ciągu znaków, dzięki czemu treść naszego pliku PDF jest dynamiczna i można ją dostosowywać. Stworzyliśmy wielowierszowy ciąg znaków zawierający treść, którą chcieliśmy umieścić w pliku PDF. Następnie utworzyliśmy instancję klasy ChromePdfRenderer z przestrzeni nazw IronPDF i użyliśmy metody RenderHtmlAsPdf do konwersji wielowierszowej treści ciągu znaków 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 jeśli spodoba Ci się to, co widzisz, cena licencji IronPDF zaczyna się już od $799. 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!