1. IronPDF
  2. 방법
  3. 국제 언어 및 문자 인코딩
C#을 사용하여 PDF 파일에 UTF-8 문자를 삽입하는 방법

C#을 사용하여 UTF-8/유니코드 PDF 파일 생성 및 국제 언어 지원

커티스 차우
커티스 차우
업데이트됨:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF는 PDF에서 UTF-8 인코딩 및 유니코드 문자를 완벽하게 지원하므로 개발자는 InputEncoding를 UTF8로 설정하고 HTML 메타 태그에 적절한 문자 집합 선언을 통해 중국어, 일본어, 아랍어, 태국어와 같은 국제 언어를 렌더링할 수 있습니다.

IronPDF는 Chrome 표준을 준수하므로 PDF에서 UTF-8 인코딩을 지원합니다. IronPDF는 Chrome 브라우저에서 제대로 표시될 수 있는 모든 문자를 지원합니다. 외국어 문자는 정확하게 표기될 것이니 안심하셔도 됩니다. 이 가이드에서는 PDF에서 UTF-8을 렌더링하는 방법을 단계별로 설명합니다.

IronPDF의 크롬 렌더링 엔진은 유니코드 문자를 완벽하게 지원하여 다국어 문서를 생성할 수 있도록 합니다. 국제 시장을 위한 애플리케이션 개발이든 단일 문서 내에서 여러 문자 세트를 처리하는 것이든, IronPDF는 모든 플랫폼에서 일관되고 정확한 렌더링을 보장합니다. 이 기능은 복잡한 문자 체계, 오른쪽에서 왼쪽으로 쓰는 언어, 특수 기호까지 확장됩니다.

빠른 시작: IronPDF로 UTF-8 인코딩 PDF 생성

이 예제는 IronPDF를 사용하여 UTF-8 인코딩으로 PDF를 생성하는 방법을 보여줍니다. InputEncoding를 UTF-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
### 최소 워크플로우(5단계) IronPDF tutorial: 4 steps to embed UTF-8 characters in PDFs using C# with installation command
  1. PDF에 UTF-8 문자를 포함하려면 IronPDF C# 라이브러리를 다운로드하세요.
  2. HTML 문자열이나 파일에 UTF-8 문자를 넣으세요.
  3. **InputEncoding** 속성을 **UTF8** 인코딩으로 설정하세요.
  4. `RenderHtmlAsPdf` 및 `RenderHtmlFileAsPdf` 메서드를 사용하여 HTML 문자열 또는 파일에서 PDF를 생성합니다.
  5. HTML **메타** 태그에 인코딩을 지정합니다.

간단한 UTF-8 PDF 예제를 어떻게 만들 수 있나요?

IronPDF를 사용할 때, UTF-8 Encoding와 같은 확장 문자 집합을 자주 사용합니다. 이는 여러 언어로 된 텍스트나 특수 기호가 포함된 PDF를 생성하는 데 필수적입니다. UTF-8 인코딩은 사용되는 언어나 문자 체계와 관계없이 모든 문자가 PDF 문서에서 올바르게 표현되고 표시되도록 보장합니다.

국제화된 애플리케이션을 개발하는 개발자에게는 UTF-8 인코딩을 올바르게 구현하는 방법을 이해하는 것이 매우 중요합니다. IronPDF는 유니코드 문자를 처리하는 간단한 방법을 제공하여 이 과정을 간소화합니다. 국제 언어 및 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> 태그로 감싸져 있습니다. RenderHtmlAsPdf와 같은 메서드를 사용하여 이 HTML 문자열을 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로 완벽하게 인코딩하려면 원하는 문자 집합을 두 곳에 지정해야 합니다. 이러한 이중 접근 방식은 렌더링 엔진과 HTML 문서 자체가 UTF-8 콘텐츠에 맞게 올바르게 구성되도록 보장합니다.

  • 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-PDF 변환을 지원합니다. 이처럼 포괄적인 언어 지원을 통해 IronPDF는 여러 언어로 PDF를 동시에 생성해야 하는 글로벌 애플리케이션에 적합합니다.

해외 사용자를 대상으로 애플리케이션을 개발할 때는 적절한 언어 지원이 매우 중요합니다. IronPDF의 유니코드 지원 덕분에 대상 언어나 지역에 관계없이 PDF가 올바르게 표시됩니다. 다양한 언어의 글꼴을 다루는 방법에 대한 자세한 내용은 글꼴 관리 가이드를 참조하십시오.

외국어를 다룰 때 고려해야 할 사항은 두 가지입니다.

내 문자 세트를 지원하는 글꼴은 무엇입니까?

사용하려는 문자 집합을 지원하는 글꼴이 서버에 설치되어 있어야 합니다. 이러한 글꼴은 일반적으로 최신 웹 서버에 자동으로 설치되지만, 구형 서버에는 Arial과 같이 UTF-8을 완벽하게 지원하지 않는 일부 글꼴의 이전 버전이 설치되어 있을 수 있습니다.

글꼴 관련 문제, 특히 다른 환경에 배포할 때 발생하는 문제를 해결하려면 글꼴 문제 해결 가이드를 참조하세요. Azure 또는 AWS와 같은 클라우드 서비스에 배포하는 경우 Azure 배포 가이드 또는 AWS 배포 가이드에 자세히 설명된 대로 글꼴을 올바르게 설치해야 할 수 있습니다.

또 다른 해결책은 Google Fonts에서 제공하는 것과 같은 웹 글꼴을 CSS에 지정하는 것입니다. 자세한 내용은 "다음 웹 디자인 프로젝트에서 Google 글꼴을 사용하는 방법"이라는 글에서 확인할 수 있습니다. IronPDF는 웹 글꼴을 완벽하게 지원하므로 특수 문자 세트를 사용하거나 여러 플랫폼에서 일관된 글꼴 렌더링이 필요한 경우 특히 유용합니다.

입력 인코딩을 올바르게 설정하는 방법은 무엇인가요?

문서를 올바르게 표시하려면 입력 인코딩을 지정해야 할 수도 있습니다. PDF에서 문자를 정확하게 표현하려면 올바른 인코딩 설정이 필수적입니다. 다음은 올바른 인코딩을 보장하는 방법입니다.

HTML "메타 문자셋" 태그 추가 예시

<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('UTF-8 텍스트'); pdf.SaveAs('output.pdf');

IronPDF는 어떻게 유니코드 문자 호환성을 보장합니까?

IronPDF는 Chrome의 렌더링 표준을 준수하므로 UTF-8 인코딩과 유니코드 문자를 완벽하게 지원합니다. 따라서 Chrome에서 올바르게 렌더링되는 모든 문자는 IronPDF로 생성된 PDF에서도 정확하게 표시됩니다.

커티스 차우
커티스 차우
  지금 바로 엔지니어링 팀과 채팅하세요
기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?
Nuget 다운로드 17,527,568 | 버전: 2026.2 방금 출시되었습니다