IronPDF를 사용하여 C#에서 PDF에 이미지를 추가하는 방법

RenderHtmlAsPdf 메서드가 가장 효과적인 이유는 무엇일까요?

RenderHtmlAsPdf 메서드는 IronPDF의 Chrome 렌더링 엔진을 활용하여 레이아웃과 스타일을 유지하면서 이미지 등을 포함한 HTML 콘텐츠를 PDF 형식으로 변환합니다. 이 방법은 반응형 CSS 레이아웃을 지원하며 이미지가 웹 브라우저에 표시되는 그대로 렌더링되도록 합니다. 복잡한 레이아웃의 경우, 픽셀 단위까지 정확한 HTML 서식 지정에 대한 가이드를 참조하세요.

지원되는 이미지 형식은 무엇입니까?

IronPDF는 HTML 변환을 통해 이미지를 삽입할 때 PNG, JPG, SVG, GIF, BMP를 포함한 모든 주요 이미지 형식을 지원합니다. 이 라이브러리는 확장 가능한 벡터 일러스트레이션을 위해 SVG 그래픽을 효과적으로 처리합니다. 다른 형식의 이미지를 사용할 때는 HTML에서 src 속성이나 Base64 데이터 URI에 이미지 유형을 올바르게 지정해야 합니다.

URL을 직접 사용하는 경우와 Base64 인코딩을 사용하는 경우 중 어떤 것이 더 적절할까요?

이미지가 온라인에 호스팅되어 있고 파일 크기가 중요한 경우, 직접 URL을 사용하세요. 인터넷 접속이 필요 없는 독립형 PDF 파일의 경우 Base64 인코딩을 선택하세요. 클라우드 서비스에 저장된 이미지의 경우 Azure Blob Storage에서 이미지를 임베드하는 방법 에 대한 가이드를 참조하세요. 이 결정은 생성된 PDF 파일의 크기와 휴대성에 모두 영향을 미칩니다.

:path=/static-assets/pdf/content-code-examples/how-to/add-images-to-pdfs-embed-image.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

string html = @"<img src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>";

// Render HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Export PDF
pdf.SaveAs("embedImage.pdf");

이미지에 Base64 인코딩을 사용하는 이유는 무엇일까요?

Base64 인코딩은 외부 리소스에 의존하지 않는 자체 포함형 PDF를 생성하므로 인터넷 연결이 없거나 원본 이미지 파일이 이동 또는 삭제되더라도 이미지가 항상 표시됩니다. 이 기술은 Blazor Server 애플리케이션에서 PDF를 생성 하거나 외부 파일 액세스가 제한될 수 있는 Azure에 배포할 때 유용합니다. 인코딩된 이미지는 HTML 문자열의 일부가 되므로 HTML 문자열을 PDF로 변환하는 데 이상적입니다.

성능 관련 고려 사항은 무엇인가요?

Base64 인코딩은 파일 크기를 약 33% 증가시키지만 외부 종속성을 제거하므로 아카이빙 목적이나 제한된 네트워크 환경에 이상적입니다. 성능이 중요한 경우, 여러 이미지 변환을 동시에 처리하기 위해 비동기 PDF 생성을 사용하는 것을 고려하십시오. 대규모 운영의 경우, 처리량을 극대화하기 위한 성능 최적화 가이드를 참조하십시오.

대용량 이미지 파일은 어떻게 처리해야 하나요?

대용량 이미지의 경우, PDF 파일 크기를 최소화하려면 Base64 인코딩 전에 압축하거나, 파일 크기가 중요한 경우 외부 URL을 사용하십시오. IronPDF는 파일 크기를 최대 75%까지 줄일 수 있는 PDF 압축 기능을 제공합니다. 여러 이미지를 다룰 때는 품질과 파일 크기 사이의 최적의 균형을 위해 렌더링 설정을 최적화하십시오 .

:path=/static-assets/pdf/content-code-examples/how-to/add-images-to-pdfs-base64-image.cs

using IronPdf;
using System;
using System.IO;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Import image file binary data
byte[] binaryData = File.ReadAllBytes("ironpdf-logo-text-dotnet.svg");

// Convert the binary data to base 64
string imgDataUri = Convert.ToBase64String(binaryData);

// Embed in HTML
string html = $"<img src='data:image/svg+xml;base64,{imgDataUri}'>";

// Convert HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Export the PDF
pdf.SaveAs("embedImageBase64.pdf");

당신이 할 수 있는 다른 일들을 알아볼 준비가 되셨나요? 추가 기능에 대한 자세한 내용 은 여기 튜토리얼 페이지를 참조하세요.