1. IronPDF
  2. 操作指南
  3. 國際語言和字符編碼
如何使用 C# 在 PDF 檔案中嵌入 UTF-8 字符

How to Use UTF-8 Encoding and International Languages in PDFs

Curtis Chau
Curtis Chau
更新日期:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF 支持 PDF 中的 UTF-8 編碼，因為它符合 Chrome 標準。 任何在 Chrome 瀏覽器中可以正確顯示的字符都將被 IronPDF 支持。 您可以放心，外語的字符將被正確渲染。 在這個操作指南中，我們將逐步說明如何在 PDF 中渲染 UTF-8。

快速入門：使用 IronPDF 生成 UTF-8 編碼的 PDF

此範例顯示如何使用 IronPDF 快速生成帶有 UTF-8 編碼的 PDF。 只需將 InputEncoding 設置為 UTF-8 並使用 RenderHtmlAsPdf 方法，開發人員就能確保國際字符能夠正確顯示。 該過程簡單，只需要幾行代碼，讓開發人員輕鬆開始創建 Unicode PDF。

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    var renderer = new IronPdf.ChromePdfRenderer();
renderer.RenderingOptions.InputEncoding = System.Text.Encoding.UTF8;
var pdf = renderer.RenderHtmlAsPdf("<html><head><meta charset='utf-8'></head><body>こんにちは世界</body></html>");
pdf.SaveAs("utf8-example.pdf");

  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer
class="hsg-featured-snippet">

簡易工作流程（5 步驟）

如何在 C# 的 PDF 中嵌入 UTF-8 字符
  1. 下載 IronPDF C# 庫以在 PDF 中嵌入 UTF-8 字符
  2. 將 UTF-8 字符放入 HTML 字串或文件中
  3. 將 InputEncoding 屬性設置為 UTF8 編碼
  4. 使用 RenderHtmlAsPdf 和 RenderHtmlFileAsPdf 方法從 HTML 字串或文件生成 PDF
  5. 在 HTML meta 標籤中指定編碼

簡單代碼範例

在使用 IronPDF 時，我們經常使用擴展的字符集，比如 UTF-8 編碼。

這裡有一個示例，將字串傳遞給 RenderHtmlAsPdf 方法，此方法期望接收一個 HTML 字串輸入：

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

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

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

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

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

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

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

上面的文本包裹在 <p> 標籤中，因為我們是在處理 HTML 字串。 您可以使用 RenderHtmlAsPdf 等方法將此 HTML 字串傳遞給 IronPDF 的 Chrome PDF 渲染器。

: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");
Imports IronPdf

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

Private renderer = New ChromePdfRenderer()
renderer.RenderingOptions.InputEncoding = System.Text.Encoding.UTF8

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

這是代碼生成的文件：

為確保您的 HTML 以 PDF 格式完美編碼，請在兩個地方指定所需的字符集：

  • 在 ChromePdfRenderer.RenderingOptions 中使用 System.Text.Encoding.UTF8
  • 在您的 HTML 標頭中：
<html>
    <head>
        <meta charset='utf-8'>
    </head>
    <body>
        こんにちは世界
    </body>
</html>
<html>
    <head>
        <meta charset='utf-8'>
    </head>
    <body>
        こんにちは世界
    </body>
</html>
HTML

關於國際語言的更多信息

IronPDF 支持非拉丁文字語言的 HTML-To-PDF，包括中文、日文、阿拉伯文、希伯來文、俄文、泰文，以及所有由 Unicode 支持的國際語言，包括混合語言文檔。

在處理國際語言時，有兩件事需要考慮：

字體

必須在您的伺服器上安裝支持您字符集的字體。 這些通常在現代網路伺服器上自動安裝，但老舊伺服器可能安裝了早期版本的某些字體，如 Arial，可能不完全支持 UTF-8。

另一個解決方案是在您的 CSS 中指定網路字體，例如 Google Fonts 提供的那些。 更多信息可以在文章 如何在下次網頁設計項目中使用 Google Fonts 中找到。

輸入編碼

您可能需要指定文檔的輸入編碼以正確渲染。 您可以通過以下方式進行：

添加 HTML "Meta Charset" 標籤，例如:

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

準備看看您還能做哪些其他事情嗎？ 查看我們的教程頁面：附加功能

常見問題解答

如何在 C# 中建立 UTF-8 編碼的 PDF 檔案？

若要在 C# 中建立 UTF-8 編碼的 PDF，請使用 IronPDF 的RenderHtmlAsPdf方法。首先，請確保您的 HTML 內容包含 UTF-8 編碼的字符，然後在渲染之前將InputEncoding屬性設為 UTF-8。

為什麼在產生 PDF 時 UTF-8 編碼很重要？

UTF-8 編碼對於 PDF 生成至關重要，因為它支援所有 Unicode 字符，確保國際字符和特殊字符的準確呈現。 IronPDF 採用 UTF-8 編碼以符合現代 Web 標準，使其能夠支援多種語言。

UTF-8 PDF 產生通常面臨哪些挑戰？

常見的挑戰包括確保非拉丁文字的正確字元渲染，以及管理支援多種字元集的字體。 IronPDF 透過允許使用 Google Fonts 等網頁字體並在 HTML 中設定正確的字元集來解決這些問題。

如何使用 C# 在 PDF 中渲染非拉丁文字？

若要使用 C# 在 PDF 中渲染非拉丁文字，請使用 IronPDF。請確保您的 HTML 內容包含必要的字元集，並在需要時指定相容的 Web 字型。 IronPDF 可以處理中文、日文或阿拉伯文等文字的渲染。

為了確保我的PDF檔案採用正確的UTF-8編碼，我應該遵循哪些步驟？

為確保 PDF 檔案採用正確的 UTF-8 編碼，請使用 IronPDF 並在 HTML 中加入meta charset="UTF-8"標籤。同時，將ChromePdfRenderer.RenderingOptions.InputEncoding設定為 UTF-8。

如何排查使用 C# 產生的 PDF 檔案中的編碼問題？

如果遇到編碼問題，請檢查您的 HTML 程式碼是否包含meta charset="UTF-8"標籤，以及您使用的字體是否支援您的字元。 IronPDF 讓您指定這些設定來解決編碼問題。

我可以使用 Google Fonts 來改善 PDF 中的國際語言支援嗎？

是的，Google Fonts 可以用來提升 PDF 的國際語言支援。使用 IronPDF，您可以在 HTML 中指定這些網頁字體，並確保所有字元在產生的 PDF 中都能正確顯示。

「Meta Charset」標籤在PDF生成中扮演什麼角色？

「Meta Charset」標籤定義了HTML內容的字元編碼，這對於在PDF中正確渲染文字至關重要。 IronPDF使用此標籤來確保UTF-8編碼的字元能夠被準確處理。

使用 UTF-8 編碼產生 PDF 時，IronPDF 是否與 .NET 10 完全相容？

是的－IronPDF 完全相容於 .NET 10，包括涉及 UTF-8 或 Unicode 編碼 HTML 的工作流程。在 .NET 10 下運行時，您仍然可以像在早期 .NET 版本中一樣使用ChromePdfRenderer.InputEncoding = System.Text.Encoding.UTF8並包含 ` <meta charset="UTF-8"> 標籤。 IronPDF 在其功能文件中聲明「完全相容 .NET 10」。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位，專注於前端開發，擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面，喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 有著濃厚的興趣，探索將硬體和軟體結合的創新方式。在閒暇時間，他喜愛遊戲並構建 Discord 機器人，結合科技與創意的樂趣。

準備好開始了嗎？
Nuget 下載 16,154,058 | 版本： 2025.11 剛剛發布