IronPDF에서 RenderHtmlAsPdf()를 사용할 때 이모지가 렌더링되지 않음

업데이트됨:6월 9, 2026

Translated

View the article in English

이모지 문자가 포함된 HTML을 RenderHtmlAsPdf()을 사용하여 렌더링할 때 브라우저 인쇄 미리 보기에서는 올바르게 표시되지만, 결과 PDF에서 이모지 문자가 나타나지 않습니다. HTML은 올바르게 UTF-8로 인코딩되어 있습니다.

문자열 기반 RenderHtmlAsPdf() 메서드는 출력 PDF에서 이모지 문자가 누락되게 하는 유니코드 처리 제한이 있습니다. "파일 기반 렌더링은 실제 브라우저에 더 가까운 컨텍스트에서 콘텐츠를 처리하여 유니코드 및 이모지 처리를 개선합니다."

해결책

옵션 1: RenderHtmlFileAsPdf() 사용

"HTML 콘텐츠를 임시 파일로 작성하고 파일 경로에서 렌더링하십시오."

string tempPath = Path.GetTempFileName() + ".html";
File.WriteAllText(tempPath, htmlContent, System.Text.Encoding.UTF8);

var renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlFileAsPdf(tempPath);

File.Delete(tempPath);
pdf.SaveAs("output.pdf");

string tempPath = Path.GetTempFileName() + ".html";
File.WriteAllText(tempPath, htmlContent, System.Text.Encoding.UTF8);

var renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlFileAsPdf(tempPath);

File.Delete(tempPath);
pdf.SaveAs("output.pdf");

Imports System.IO
Imports System.Text
Imports IronPdf

Dim tempPath As String = Path.GetTempFileName() & ".html"
File.WriteAllText(tempPath, htmlContent, Encoding.UTF8)

Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlFileAsPdf(tempPath)

File.Delete(tempPath)
pdf.SaveAs("output.pdf")

$vbLabelText $csharpLabel

옵션 2: 이모지를 숫자 HTML 엔티티로 변환

"렌더링 전에 이모지 문자를 숫자 HTML 엔티티의 동등한 것으로 대체하십시오."


&#128075;

&#128522;


&#128075;

&#128522;

HTML

"옵션 1은 템플릿에 많은 이모지 문자가 포함되어 있을 때 반복된 엔티티 조회를 방지합니다."

Curtis Chau

지금 바로 엔지니어링 팀과 채팅하세요

기술 문서 작성자

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

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

시작할 준비 되셨나요?

Nuget 다운로드 20,088,359 | 버전: 2026.7 방금 출시