C#を使用してPDFファイルにUTF-8文字を埋め込む方法

国際言語で UTF-8 / Unicode PDF を作成するために C#35 を使用する

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

IronPDFはPDFのUTF-8エンコーディングとユニコード文字を完全にサポートしており、開発者はInputEncodingUTF8に設定し、HTMLメタタグで適切な文字セット宣言を行うことで、中国語、日本語、アラビア語、タイ語などの国際言語をレンダリングすることができます。

IronPDFはGoogle Chrome標準に準拠しているため、PDFでのUTF-8エンコーディングをサポートしています。 Chromeブラウザー内で正しく表示できるすべての文字は、IronPDFによってサポートされます。 外国語の文字が正しくレンダリングされることを保証できます。 このハウツーでは、UTF-8をPDFでレンダリングする方法をステップごとに説明します。

IronPdfのChromeレンダリングエンジンはユニコード文字を完全にサポートし、多言語ドキュメントの作成を可能にします。 国際市場向けのアプリケーションを開発する場合でも、1つのドキュメントで複数の文字セットを扱う場合でも、IronPdfはすべてのプラットフォームで一貫性のある正確なレンダリングを保証します。 この能力は、複雑なスクリプト、右から左への言語、特殊記号にも及びます。

クイックスタート: IronPDFでUTF-8エンコードされたPDFを生成する

この例ではIronPDFを使ってUTF-8エンコーディングのPDFを生成する方法を示します。 InputEncodingUTF-8に設定し、RenderHtmlAsPdfメソッドを使用することで、開発者は国際的な文字が正しく表示されるようにすることができます。 必要なのは数行のコードのみです。

Nuget Icon今すぐ NuGet で PDF を作成してみましょう:

  1. NuGet パッケージ マネージャーを使用して IronPDF をインストールします

    PM > Install-Package IronPdf

  2. このコード スニペットをコピーして実行します。

    // 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. 実際の環境でテストするためにデプロイする

    今すぐ無料トライアルでプロジェクトに IronPDF を使い始めましょう
    arrow pointer

シンプルなUTF-8 PDFの例を作成するにはどうすればよいですか?

IronPDFで作業する場合、UTF-8 Encodingのような拡張文字セットを使用することがよくあります。 これは、複数の言語のテキストや特殊な記号を含むPDFを作成する際に不可欠です。 UTF-8エンコーディングは、使用されている言語やスクリプトに関係なく、すべての文字がPDF文書内で適切に表現され、表示されることを保証します。

国際的なアプリケーションを扱う開発者にとって、UTF-8エンコーディングを適切に実装する方法を理解することは非常に重要です。 IronPdfはUnicode文字を扱う簡単な方法を提供することで、このプロセスを簡素化します。 国際言語とCMJKの取り扱いについては、トラブルシューティングガイドをご覧ください。

ここでは、HTML文字列入力を期待するRenderHtmlAsPdfメソッドに渡される文字列の例を示します。

// 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

上記のテキストは、HTML文字列を扱っているため<p>タグで囲まれています。 このHTML文字列をRenderHtmlAsPdfのような方法でIronPDFのChrome PDFレンダラーに渡すことができます。 より複雑なHTML文書については、HTMLから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");
$vbLabelText   $csharpLabel

UTF-8コンテンツを扱う場合、IronPDFがどのように異なるタイプのコンテンツを扱うかを理解することが重要です。 同様の方法で、UTF-8文字を含むHTMLファイルを変換することもできます。 さらに、適切な文字表示を確保するためにウェブフォントを使用している場合は、ウェブフォントとアイコンフォントの使用に関するガイドをご覧ください。

これはコードによって生成されたファイルです:

HTMLをPDFとして完璧にエンコードするために、2か所で希望の文字コードを指定してください。 この二重のアプローチにより、レンダリングエンジンと HTML ドキュメント自体の両方が、UTF-8コンテンツ用に適切に設定されていることが保証されます:

  • ChromePdfRenderer.RenderingOptionsSystem.Text.Encoding.UTF8を使用する
  • HTMLヘッダー内で:
<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

国際言語サポートについて知っておくべきことは何ですか?

IronPDFは、中国語、日本語、アラビア語、ヘブライ語、ロシア語、タイ語を含む非ラテン文字スクリプト言語でのHTML-To-PDFをサポートしており、Unicodeがサポートするすべての国際言語(混合言語文書を含む)をサポートしています。 この包括的な言語サポートにより、IronPdfは複数の言語で同時にPDFを生成する必要のあるグローバルなアプリケーションに適しています。

海外向けのアプリケーションを開発する場合、適切な言語サポートは非常に重要です。 IronPDFのUnicodeサポートは、ターゲット言語や地域に関係なく、PDFが正しく表示されることを保証します。 異なる言語でのフォントの取り扱いに関する詳細情報については、当社のフォント管理ガイドを参照してください。

国際言語を扱う際に考慮すべきことが2つあります:

どの書体が私の文字セットをサポートしていますか?

文字セットをサポートするフォントがサーバーにインストールされている必要があります。 通常は現代のWebサーバーに自動的にインストールされていますが、古いサーバーにはArialなどのフォントの古いバージョンがインストールされている場合があり、完全なUTF-8サポートがないかもしれません。

フォント関連のトラブルシューティング、特に異なる環境にデプロイする場合のトラブルシューティングについては、フォントのトラブルシューティングに関するガイドをご覧ください。 AzureやAWSのようなクラウドサービスにデプロイする場合は、AzureデプロイメントガイドやAWSデプロイメントガイドで詳しく説明されているように、適切なフォントのインストールを確認する必要があるかもしれません。

代替ソリューションは、Googleフォントによって提供されるようなWebフォントをCSSで指定することです。 詳細については、次のウェブデザインプロジェクトでGoogleフォントを使用する方法をご覧ください。 IronPdfはウェブフォントを完全にサポートしており、特殊な文字セットや異なるプラットフォーム間で一貫したフォントレンダリングが必要な場合に特に役立ちます。

正しい入力エンコードを設定するにはどうすればよいですか?

ドキュメントを正しくレンダリングするために、入力エンコーディングを指定する必要がある場合があります。 PDFの正確な文字表現には、適切なエンコーディング設定が不可欠です。 以下は、正しいエンコードを保証するための方法です:

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

さらに、外部ソースやファイルからUTF-8のコンテンツを扱う場合、さまざまなエンコーディングシナリオを処理する必要があります。 新しいPDFを作成するための包括的なガイドでは、エンコードされたコンテンツを扱うためのさまざまなアプローチについて説明しています。

複数の言語や複雑なレイアウトを含む高度なシナリオのために、IronPDFは広範な設定オプションを提供します。 レンダリングオプションガイドで詳しく説明しているように、ページの向きや余白など、PDF生成のさまざまな側面を制御することができます。

次に何ができるのかを見てみましょうか? チュートリアルのページはこちらをご覧ください:その他の機能

よくある質問

C# で UTF-8 エン コ ーデ ィ ン グ さ れた PDF を作成す る 方法は?

IronPDFでUTF-8エンコードPDFを作成するには、ChromePdfRendererを初期化し、renderer.RenderingOptions.InputEncoding = System.Text.Encoding.UTF8でInputEncodingプロパティをUTF8に設定し、RenderHtmlAsPdfメソッドで国際文字を含むHTMLをPDFに変換します。

IronPDFはどの言語のPDFをサポートしていますか?

IronPdfは中国語、日本語、アラビア語、タイ語、その他ユニコード文字を使用する言語を含むすべての国際言語に対応しています。Chromeブラウザでレンダリングできる文字であれば、IronPDFで生成されたPDFで適切に表示されます。

UTF-8をサポートするために、HTMLに何か特別な記述をする必要がありますか?

国際的な文字を使用する場合は、常にHTMLにmeta charset='utf-8'タグを含める必要があります。これによりIronPDFがHTMLをPDFにレンダリングする際に適切な文字エンコーディングが保証されます。

IronPdfは右から左への言語や複雑なスクリプトに対応できますか?

IronPDFのChromeレンダリングエンジンは複雑なスクリプトやアラビア語やヘブライ語のような右から左への言語を完全にサポートし、すべてのプラットフォームで一貫した正確なレンダリングを保証します。

UTF-8のPDFを生成するために必要な最小限のコードは何ですか?

var renderer = new IronPdf.ChromePdfRenderer(); renderer.RenderingOptions.InputEncoding = System.Text.Encoding.UTF8; var pdf = renderer.RenderHtmlAsPdf('Your UTF-8 text'); pdf.SaveAs('output.pdf');

IronPdfはどのようにユニコード文字の互換性を確保していますか?

IronPDFはChrome標準のレンダリングに準拠しており、UTF-8エンコーディングとUnicode文字を完全にサポートしています。これにより、Chromeで正しくレンダリングされた文字はIronPDFで作成されたPDFでも正確に表示されます。

カーティス・チャウ
テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT(Internet of Things)への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はできましたか?
Nuget ダウンロード 17,012,929 | バージョン: 2025.12 リリース