Wie man UTF-8-Zeichen in PDF-Dateien mit C# einbettet

Using C# to Create UTF-8 / Unicode PDFs with International Languages

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF unterstützt vollständig die UTF-8-Kodierung und Unicode-Zeichen in PDFs, so dass Entwickler internationale Sprachen wie Chinesisch, Japanisch, Arabisch und Thailändisch wiedergeben können, indem sie InputEncoding auf UTF8 setzen und die korrekte Zeichensatzdeklaration in HTML-Meta-Tags sicherstellen.

IronPDF unterstützt die UTF-8-Kodierung in PDFs, weil es dem Chrome-Standard entspricht. Jedes Zeichen, das in einem Chrome-Browser ordnungsgemäß gerendert werden kann, wird von IronPDF unterstützt. Sie können sicher sein, dass fremde Sprachen ihre Zeichen korrekt dargestellt bekommen. In dieser Anleitung werden wir Schritt für Schritt durchgehen, wie Sie UTF-8 in einem PDF rendern können.

Die Chrome-Rendering-Engine von IronPDF bietet vollständige Unterstützung für Unicode-Zeichen und ermöglicht so die Erstellung mehrsprachiger Dokumente. Ob bei der Entwicklung von Anwendungen für internationale Märkte oder bei der Handhabung mehrerer Zeichensätze innerhalb eines einzigen Dokuments - IronPDF gewährleistet eine konsistente und genaue Darstellung auf allen Plattformen. Diese Fähigkeit erstreckt sich auch auf komplexe Skripte, Rechts-nach-Links-Sprachen und spezielle Symbole.

Schnellstart: Erstellen von UTF-8-kodierten PDFs mit IronPDF

Dieses Beispiel zeigt, wie man mit IronPDF ein PDF mit UTF-8-Kodierung erzeugt. Durch die Einstellung der InputEncoding auf UTF-8 und die Verwendung der Methode RenderHtmlAsPdf können Entwickler sicherstellen, dass internationale Zeichen korrekt angezeigt werden. Der Prozess erfordert nur wenige Codezeilen.

Nuget IconLegen Sie jetzt mit NuGet los, um PDFs zu erstellen:

  1. Installieren Sie IronPDF mit dem NuGet-Paketmanager.

    PM > Install-Package IronPdf

  2. Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    // Initialize the Chrome PDF renderer
    var renderer = new IronPdf.ChromePdfRenderer();
    
    // Set the input encoding to UTF-8 to support international characters
    renderer.RenderingOptions.InputEncoding = System.Text.Encoding.UTF8;
    
    // Render HTML containing Japanese text to PDF
    // Note: Always include meta charset='utf-8' in your HTML
    var pdf = renderer.RenderHtmlAsPdf("<html><head><meta charset='utf-8'></head><body>こんにちは世界</body></html>");
    
    // Save the PDF with UTF-8 content
    pdf.SaveAs("utf8-example.pdf");
  3. Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute mit der Nutzung von IronPDF in Ihrem Projekt – mit einer kostenlosen Testversion.
    arrow pointer

Wie kann ich ein einfaches UTF-8-PDF-Beispiel erstellen?

Bei der Arbeit mit IronPDF verwenden wir häufig erweiterte Zeichensätze wie die UTF-8-Kodierung. Dies ist wichtig für die Erstellung von PDFs, die Text in mehreren Sprachen oder spezielle Symbole enthalten. Die UTF-8-Kodierung stellt sicher, dass alle Zeichen in Ihren PDF-Dokumenten korrekt dargestellt und angezeigt werden, unabhängig von der verwendeten Sprache oder Schrift.

Für Entwickler, die mit internationalen Anwendungen arbeiten, ist es wichtig zu wissen, wie man die UTF-8-Kodierung richtig implementiert. IronPDF vereinfacht diesen Prozess, indem es unkomplizierte Methoden zum Umgang mit Unicode-Zeichen bereitstellt. Mehr über die Arbeit mit internationalen Sprachen und CMJK erfahren Sie in unserem Leitfaden zur Fehlerbehebung.

Hier haben wir ein Beispiel dafür, wie der String in die Methode RenderHtmlAsPdf übergeben wird, die einen HTML-String als Eingabe erwartet:

// Example HTML content containing text in multiple languages
// Japanese, Arabic, and Thai text samples for demonstration
string htmlContent = @"
    <p>周態告応立待太記行神正用真最。音日独素円政進任見引際初携食。更火識将回興継時億断保媛全職。
    文造画念響竹都務済約記求生街東。天体無適立年保輪動元念足総地作靖権瀬内。
    失文意芸野画美暮実刊切心。感変動技実視高療試意写表重車棟性作家薄井。
    陸瓶右覧撃稿法真勤振局夘決。任堀記文市物第前兜純響限。囲石整成先尾未展退幹販山令手北結。</p>

    <p>أم يذكر النفط قبضتهم على, الصين وفنلندا ما حدى. تم لكل أملا المنتصر,
    ٣٠ حدى مارد القوى. شرسة للسيطرة قامفي. حتى أم يطول المحيط,
    زهاء وحلفاؤها من فعل. لم قامت الجو الساحلية وتم, ويعزى واقتصار قبل كل.</p>

    <p>ภคนทลาพาธสตารเซฟต แชมป มารเกตตงลมเหลวโยเกรต แลนดบาบนอมครม รสโซ แบรนดไคลแมกซ พซซาโมเดลเสอโครง มอบโซนรายชอ
    แอดมชชน ดอกเตอร พะเรอ มารคเจไดโมจราสเบอรร เอนทรานซออดชนศลปวฒนธรรมเปราะบาง โมจซเรยสวอลนตทรปลเมอร ทป วาไรตบกเมเปล</p>
";
// Example HTML content containing text in multiple languages
// Japanese, Arabic, and Thai text samples for demonstration
string htmlContent = @"
    <p>周態告応立待太記行神正用真最。音日独素円政進任見引際初携食。更火識将回興継時億断保媛全職。
    文造画念響竹都務済約記求生街東。天体無適立年保輪動元念足総地作靖権瀬内。
    失文意芸野画美暮実刊切心。感変動技実視高療試意写表重車棟性作家薄井。
    陸瓶右覧撃稿法真勤振局夘決。任堀記文市物第前兜純響限。囲石整成先尾未展退幹販山令手北結。</p>

    <p>أم يذكر النفط قبضتهم على, الصين وفنلندا ما حدى. تم لكل أملا المنتصر,
    ٣٠ حدى مارد القوى. شرسة للسيطرة قامفي. حتى أم يطول المحيط,
    زهاء وحلفاؤها من فعل. لم قامت الجو الساحلية وتم, ويعزى واقتصار قبل كل.</p>

    <p>ภคนทลาพาธสตารเซฟต แชมป มารเกตตงลมเหลวโยเกรต แลนดบาบนอมครม รสโซ แบรนดไคลแมกซ พซซาโมเดลเสอโครง มอบโซนรายชอ
    แอดมชชน ดอกเตอร พะเรอ มารคเจไดโมจราสเบอรร เอนทรานซออดชนศลปวฒนธรรมเปราะบาง โมจซเรยสวอลนตทรปลเมอร ทป วาไรตบกเมเปล</p>
";
$vbLabelText   $csharpLabel

Der obige Text ist in <p>-Tags eingefasst, da wir es mit einem HTML-String zu tun haben. Sie können diesen HTML-String mithilfe von Methoden wie RenderHtmlAsPdf an IronPDFs Chrome PDF Renderer übergeben. Für komplexere HTML-Dokumente können Sie sich unseren Leitfaden zur Konvertierung von HTML in PDF ansehen.

:path=/static-assets/pdf/content-code-examples/how-to/utf-8.cs
using IronPdf;

const string html_with_utf_8 =
    @"<p>周態告応立待太記行神正用真最。音日独素円政進任見引際初携食。更火識将回興継時億断保媛全職。
    文造画念響竹都務済約記求生街東。天体無適立年保輪動元念足総地作靖権瀬内。
    失文意芸野画美暮実刊切心。感変動技実視高療試意写表重車棟性作家薄井。
    陸瓶右覧撃稿法真勤振局夘決。任堀記文市物第前兜純響限。囲石整成先尾未展退幹販山令手北結。</p>
    <p>
    أم يذكر النفط قبضتهم على, الصين وفنلندا ما حدى. تم لكل أملاً المنتصر,
    ٣٠ حدى مارد القوى. شرسة للسيطرة قامفي. حتى أم يطول المحيط,
    زهاء وحلفاؤها من فعل. لم قامت الجو الساحلية وتم, ويعزى واقتصار قبل كل.
    </p>
    <p>
    ภคันทลาพาธสตาร์เซฟตี้ แชมป์ มาร์เก็ตติ้งล้มเหลวโยเกิร์ต แลนด์บาบูนอึมครึม รุสโซ แบรนด์ไคลแม็กซ์ พิซซ่าโมเดลเสือโคร่ง ม็อบโซนรายชื่อ
    แอดมิชชั่น ด็อกเตอร์ พะเรอ มาร์คเจไดโมจิราสเบอร์รี เอนทรานซ์ออดิชั่นศิลปวัฒนธรรมเปราะบาง โมจิซีเรียสวอลนัตทริปลีเมอร์ ทิป วาไรตี้บิ๊กเมเปิล
    </p>";

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.InputEncoding = System.Text.Encoding.UTF8;

var pdf = renderer.RenderHtmlAsPdf(html_with_utf_8);
pdf.SaveAs("Unicode.pdf");
$vbLabelText   $csharpLabel

Bei der Arbeit mit UTF-8-Inhalten ist es wichtig zu wissen, wie IronPDF die verschiedenen Arten von Inhalten behandelt. Sie können auch HTML-Dateien, die UTF-8-Zeichen enthalten, mit ähnlichen Methoden konvertieren. Wenn Sie außerdem mit Webfonts arbeiten, um eine korrekte Zeichendarstellung zu gewährleisten, lesen Sie unseren Leitfaden zur Verwendung von Webfonts und Icon Fonts.

Dies ist die Datei, die der Code erzeugt hat:

Um eine perfekte Kodierung Ihrer HTML-Datei als PDF zu gewährleisten, geben Sie den gewünschten Zeichensatz an zwei Stellen an. Dieser duale Ansatz stellt sicher, dass sowohl die Rendering-Engine als auch das HTML-Dokument selbst für UTF-8-Inhalte richtig konfiguriert sind:

  • In ChromePdfRenderer.RenderingOptions mithilfe von System.Text.Encoding.UTF8
  • In Ihrem HTML-Header:
<html>
    <head>
        <!-- Always include UTF-8 charset declaration for proper encoding -->
        <meta charset='utf-8'>
    </head>
    <body>
        こんにちは世界
    </body>
</html>
<html>
    <head>
        <!-- Always include UTF-8 charset declaration for proper encoding -->
        <meta charset='utf-8'>
    </head>
    <body>
        こんにちは世界
    </body>
</html>
HTML

Was sollte ich über internationale Sprachunterstützung wissen?

IronPDF unterstützt HTML-zu-PDF in nicht-lateinischen Schriftsprachen, einschließlich Chinesisch, Japanisch, Arabisch, Hebräisch, Russisch, Thailändisch und alle von Unicode unterstützten internationalen Sprachen, einschließlich gemischter Sprachdokumente. Dank dieser umfassenden Sprachunterstützung eignet sich IronPDF für globale Anwendungen, die PDFs in mehreren Sprachen gleichzeitig erzeugen müssen.

Bei der Entwicklung von Anwendungen für internationale Zielgruppen ist eine angemessene Sprachunterstützung von entscheidender Bedeutung. Die Unicode-Unterstützung von IronPDF gewährleistet, dass Ihre PDFs unabhängig von der Zielsprache oder -region korrekt angezeigt werden. Ausführlichere Informationen zum Umgang mit Schriftarten in verschiedenen Sprachen finden Sie in unserem Leitfaden zur Schriftartenverwaltung.

Es gibt zwei Dinge, die zu beachten sind, wenn man mit internationalen Sprachen arbeitet:

Welche Schriftarten unterstützen meinen Zeichensatz?

Eine Schriftart, die Ihr Zeichensatz unterstützt, muss auf Ihrem Server installiert sein. Diese sind normalerweise auf modernen Webservern automatisch installiert, aber ältere Server könnten mit älteren Versionen einiger Schriftarten wie Arial installiert worden sein, die möglicherweise keine vollständige UTF-8-Unterstützung haben.

Für die Behebung von Problemen im Zusammenhang mit Schriftarten, insbesondere bei der Bereitstellung in verschiedenen Umgebungen, lesen Sie unseren Leitfaden zur Fehlerbehebung bei Schriftarten. Wenn Sie Cloud-Dienste wie Azure oder AWS bereitstellen, müssen Sie möglicherweise die korrekte Installation der Schriftart sicherstellen, wie in unserem Leitfaden für die Azure-Bereitstellung oder AWS-Bereitstellung beschrieben.

Eine alternative Lösung besteht darin, eine Webschriftart in Ihrem CSS anzugeben, wie z. B. die von Google Fonts bereitgestellten. Weitere Informationen finden Sie in dem Artikel How to Use Google Fonts in Your Next Web Design Project. IronPDF unterstützt Webfonts in vollem Umfang, was besonders nützlich sein kann, wenn Sie mit speziellen Zeichensätzen arbeiten oder eine konsistente Darstellung von Schriften auf verschiedenen Plattformen benötigen.

Wie stelle ich die korrekte Eingabekodierung ein?

Eventuell müssen Sie die Eingabekodierung Ihres Dokuments angeben, damit es korrekt gerendert wird. Eine korrekte Kodierungskonfiguration ist für eine genaue Zeichendarstellung in Ihren PDFs unerlässlich. Hier sind die Methoden, die eine korrekte Kodierung gewährleisten:

Hinzufügen eines HTML-"Meta Charset"-Tags, z.B.

<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
HTML

Wenn Sie mit UTF-8-Inhalten aus externen Quellen oder Dateien arbeiten, müssen Sie möglicherweise verschiedene Kodierungsszenarien behandeln. Unser umfassender Leitfaden zur Erstellung neuer PDFs deckt verschiedene Ansätze zur Arbeit mit kodierten Inhalten ab.

Für fortgeschrittene Szenarien, die mehrere Sprachen und komplexe Layouts umfassen, bietet IronPDF umfangreiche Konfigurationsoptionen. Sie können verschiedene Aspekte der PDF-Generierung steuern, einschließlich Seitenausrichtung, Ränder und mehr, wie in unserem Leitfaden zu den Rendering-Optionen beschrieben.

Bereit zu sehen, was Sie sonst noch tun können? Sehen Sie sich hier unsere Tutorial-Seite an: Zusätzliche Funktionen

Häufig gestellte Fragen

Wie erstelle ich eine UTF-8-kodierte PDF-Datei in C#?

Um mit IronPDF UTF-8-kodierte PDFs zu erstellen, initialisieren Sie einen ChromePdfRenderer, setzen Sie die Eigenschaft InputEncoding mit renderer.RenderingOptions.InputEncoding = System.Text.Encoding.UTF8 auf UTF8 und verwenden Sie dann die Methode RenderHtmlAsPdf, um HTML mit internationalen Zeichen in PDF zu konvertieren.

Welche Sprachen unterstützt IronPDF bei der PDF-Erstellung?

IronPDF unterstützt alle internationalen Sprachen, einschließlich Chinesisch, Japanisch, Arabisch, Thai und andere Sprachen, die Unicode-Zeichen verwenden. Jedes Zeichen, das in einem Chrome-Browser gerendert werden kann, wird in den von IronPDF generierten PDFs korrekt angezeigt.

Muss ich für die UTF-8-Unterstützung etwas Besonderes in meinen HTML-Code einbauen?

Ja, Sie sollten immer ein meta charset='utf-8' Tag in Ihr HTML einfügen, wenn Sie mit internationalen Zeichen arbeiten. Dadurch wird die korrekte Zeichenkodierung sichergestellt, wenn IronPDF das HTML in PDF umwandelt.

Kann IronPDF mit Rechts-nach-Links-Sprachen und komplexen Skripten umgehen?

Ja, die Chrome-Rendering-Engine von IronPDF bietet vollständige Unterstützung für komplexe Skripte und Rechts-nach-Links-Sprachen wie Arabisch und Hebräisch und gewährleistet so eine konsistente und genaue Darstellung auf allen Plattformen.

Welcher Code ist mindestens erforderlich, um ein UTF-8-PDF zu erzeugen?

Der minimale Code erfordert nur drei Schritte: var renderer = new IronPdf.ChromePdfRenderer(); renderer.RenderingOptions.InputEncoding = System.Text.Encoding.UTF8; var pdf = renderer.RenderHtmlAsPdf('Ihr UTF-8 Text'); pdf.SaveAs('output.pdf');

Wie stellt IronPDF die Kompatibilität mit Unicode-Zeichen sicher?

IronPDF entspricht dem Chrome-Standard für das Rendering, d. h. es unterstützt die UTF-8-Kodierung und Unicode-Zeichen vollständig. Dadurch wird sichergestellt, dass jedes Zeichen, das in Chrome korrekt wiedergegeben wird, auch in den mit IronPDF erstellten PDFs korrekt angezeigt wird.

Curtis Chau
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 17,012,929 | Version: 2025.12 gerade veröffentlicht