C#에서 이미지를 PDF로 변환하는 방법

C#에서 이미지를 PDF로 변환하는 방법

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

IronPDF를 사용하면 C# 개발자가 사용자 정의 배치 동작 및 렌더링 옵션을 갖춘 ImageToPdfConverter.ImageToPdf 메서드를 사용하여 하나 또는 여러 개의 이미지(JPG, PNG, TIFF)를 PDF 문서로 변환할 수 있습니다.

이미지를 PDF로 변환하면 여러 이미지 파일(예: JPG, PNG 또는 TIFF)을 하나의 PDF 문서로 결합합니다. 이 프로세스를 통해 디지털 포트폴리오, 프레젠테이션 또는 보고서를 생성하여, 이미지 컬렉션을 체계적이고 누구나 읽을 수 있는 형식으로 쉽게 공유하고 저장할 수 있습니다.

IronPDF는 하나 또는 여러 개의 이미지를 고유한 이미지 배치 및 동작을 적용하여 PDF로 변환합니다. 이러한 동작에는 페이지에 맞추기, 페이지 중앙 정렬, 페이지 자르기가 포함됩니다. 또한 IronPDF를 사용하여 텍스트 및 HTML 머리글과 바닥글을 추가하고, 워터마크를 적용하며, 사용자 지정 페이지 크기를 설정하고, 배경 및 전경 오버레이를 포함할 수 있습니다.

빠른 시작: IronPDF를 사용하여 이미지를 PDF로 변환하기

IronPDF의 ImageToPdfConverter 클래스를 사용하여 이미지를 PDF 문서로 변환합니다. 이 예제는 이미지 파일을 PDF로 변환하는 방법을 보여 주며, 이를 통해 .NET C# 애플리케이션에 이미지-PDF 변환 기능을 통합할 수 있습니다. 최소한의 코드만으로 이미지를 PDF/A로 변환하여 디지털 포트폴리오나 보고서를 만들 수 있습니다.

  1. NuGet 패키지 관리자를 사용하여 https://www.nuget.org/packages/IronPdf 설치하기

    PM > Install-Package IronPdf
  2. 다음 코드 조각을 복사하여 실행하세요.

    IronPdf.ImageToPdfConverter.ImageToPdf("path/to/image.png").SaveAs("imageToPdf.pdf");
  3. 실제 운영 환경에서 테스트할 수 있도록 배포하세요.

    무료 체험판으로 오늘 프로젝트에서 IronPDF 사용 시작하기

    arrow pointer


단일 이미지를 PDF/A로 변환하는 방법은 무엇입니까?

클래스 내의 정적 메서드를 사용하여 이미지를 PDF 문서로 변환합니다. 이 방법은 이미지의 파일 경로만 필요로 하며, 기본 이미지 배치 및 동작을 적용하여 PDF 문서로 변환합니다. 지원되는 이미지 형식에는 .bmp, .jpeg, .jpg, .gif, .png, .svg, .tif, .tiff, .webp, .apng, .avif, .cur, .dib, .ico, .jfif, .jif, .jpe, .pjp 및 .pjpeg이 포함됩니다.

시작하기 전에 NuGet을 통해 IronPDF를 설치했거나 Windows 설치 프로그램을 다운로드했는지 확인하십시오. 이 라이브러리는 Windows, macOS, Linux 플랫폼에서 원활하게 작동하여 다양한 개발 환경에서 폭넓게 활용할 수 있습니다.

어떤 이미지 형식을 지원합니까?

회사 행사에서 보라색 유니폼을 입은 Iron Software 팀원들

IronPDF는 JPEG, PNG, BMP, GIF와 같은 래스터 형식뿐만 아니라 SVG 그래픽과 같은 벡터 형식을 포함하여 광범위한 이미지 형식을 지원합니다. 이 라이브러리는 표준 형식뿐만 아니라 WebP 및 AVIF와 같은 최신 형식도 지원하여 최신 웹 애플리케이션과의 호환성을 보장합니다. 특수한 용도로는 아이콘 파일(.ico) 및 커서 파일(.cur)을 활용하십시오.

코드는 어떻게 작성하나요?

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image.cs
using IronPdf;

string imagePath = "meetOurTeam.jpg";

// Convert an image to a PDF
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Export the PDF
pdf.SaveAs("imageToPdf.pdf");
Imports IronPdf

Private imagePath As String = "meetOurTeam.jpg"

' Convert an image to a PDF
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath)

' Export the PDF
pdf.SaveAs("imageToPdf.pdf")
$vbLabelText   $csharpLabel

더 복잡한 시나리오의 경우, 여러 이미지를 처리할 때 성능을 향상시키기 위해 비동기 PDF 생성을 고려해 보십시오. 또한 이 라이브러리는 사용자 지정 용지 크기와 여백을 지원하여 이미지가 필요한 대로 정확하게 표시되도록 합니다.

번역 결과물은 어떻게 보이나요?


여러 이미지를 PDF/A로 변환하려면 어떻게 해야 하나요?

여러 이미지를 PDF 문서로 변환하려면, 단일 파일 경로 대신 파일 경로가 포함된 `` 객체를 제공하십시오. 이렇게 하면 기본 이미지 배치 및 동작이 적용된 PDF 문서가 생성됩니다.

여러 이미지를 다룰 때는 품질 저하 없이 파일 크기를 최적화할 수 있는 PDF 압축 옵션을 고려하십시오. 이는 특히 대용량 포트폴리오나 사진 앨범을 제작할 때 중요합니다.

여러 이미지를 한 번에 처리하려면 어떻게 해야 하나요?

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-multiple-images.cs
using IronPdf;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;

// Retrieve all JPG and JPEG image paths in the 'images' folder.
IEnumerable<String> imagePaths = Directory.EnumerateFiles("images").Where(f => f.EndsWith(".jpg") || f.EndsWith(".jpeg"));

// Convert images to a PDF
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePaths);

// Export the PDF
pdf.SaveAs("imagesToPdf.pdf");
Imports IronPdf
Imports System
Imports System.Collections.Generic
Imports System.IO
Imports System.Linq

' Retrieve all JPG and JPEG image paths in the 'images' folder.
Private imagePaths As IEnumerable(Of String) = Directory.EnumerateFiles("images").Where(Function(f) f.EndsWith(".jpg") OrElse f.EndsWith(".jpeg"))

' Convert images to a PDF
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePaths)

' Export the PDF
pdf.SaveAs("imagesToPdf.pdf")
$vbLabelText   $csharpLabel

다중 이미지 PDF는 어떻게 생겼나요?


이미지 배치와 동작을 어떻게 제어할 수 있나요?

IronPDF는 다양한 이미지 배치 및 동작 옵션을 제공합니다. 이미지는 화면 중앙에 배치하거나, 가로세로 비율을 유지한 채 페이지 크기에 맞게 조정할 수 있습니다. 사용 가능한 모든 이미지 배치 및 동작은 다음과 같습니다:

  • : 이미지는 페이지의 왼쪽 상단 모서리에 배치됩니다.
  • : 이미지는 페이지의 오른쪽 상단 모서리에 배치됩니다.
  • : 이미지가 페이지 중앙에 정렬됩니다.
  • : 이미지는 원래의 가로세로 비율을 유지한 채 페이지에 맞춰집니다.
  • : 이미지는 페이지의 왼쪽 하단 모서리에 배치됩니다.
  • : 이미지는 페이지의 오른쪽 하단 모서리에 배치됩니다.
  • : 이미지가 페이지에 맞게 조정됩니다.
  • : 이미지에 맞게 페이지 크기가 조정됩니다.

이러한 배치 옵션은 IronPDF의 페이지 방향 및 회전 기능과 원활하게 연동되어, 이미지 크기에 관계없이 Professional한 문서를 생성할 수 있습니다.

코드에서 이미지 동작을 적용하려면 어떻게 해야 하나요?

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image-image-behavior.cs
using IronPdf;
using IronPdf.Imaging;

string imagePath = "meetOurTeam.jpg";

// Convert an image to a PDF with image behavior of centered on page
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, ImageBehavior.CenteredOnPage);

// Export the PDF
pdf.SaveAs("imageToPdf.pdf");
Imports IronPdf
Imports IronPdf.Imaging

Private imagePath As String = "meetOurTeam.jpg"

' Convert an image to a PDF with image behavior of centered on page
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath, ImageBehavior.CenteredOnPage)

' Export the PDF
pdf.SaveAs("imageToPdf.pdf")
$vbLabelText   $csharpLabel

이미지 동작 간의 시각적 차이점은 무엇입니까?

회사 팀 행사에서 보라색 브랜드 운동복을 입은 Iron Software 팀원들
야외 행사에서 보라색 브랜드 운동복을 입은 Iron Software 팀원들
회사 팀 행사에서 보라색 브랜드 운동복을 입은 Iron Software 팀원들
회사 스포츠 행사에서 보라색 유니폼을 입은 Iron Software 팀원들
'팀 소개' 텍스트가 겹쳐진 회사 스포츠 행사에서 보라색 운동복을 입은 Iron Software 팀원들
회사 스포츠 행사에서 보라색 브랜드 운동복을 입고 브랜드 로고가 겹쳐진 Iron Software 팀원들
'우리 팀을 만나보세요'라는 텍스트가 겹쳐진 기업 팀 행사에서 보라색 유니폼을 입은 Iron Software 팀원들
기업 팀 행사에서 보라색 브랜드 운동복을 입은 Iron Software 팀원들

PDF 렌더링 옵션을 어떻게 사용자 지정하나요?

정적 메서드는 이미지를 HTML 태그로 가져온 다음, 해당 HTML을 PDF로 변환합니다. 이를 통해 `` 객체를 세 번째 매개변수로 전달하여 렌더링 프로세스를 직접 사용자 정의할 수 있습니다.

이 접근 방식을 통해 JavaScript 실행, CSS 미디어 유형, 뷰포트 구성 등 IronPDF에서 제공하는 모든 강력한 렌더링 옵션을 활용할 수 있습니다. 웹 폰트와 아이콘을 활용하여 문서의 시각적 매력을 높일 수도 있습니다.

헤더와 사용자 지정 스타일을 추가하려면 어떻게 해야 하나요?

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image-rendering-options.cs
using IronPdf;

string imagePath = "meetOurTeam.jpg";

ChromePdfRenderOptions options = new ChromePdfRenderOptions()
{
    HtmlHeader = new HtmlHeaderFooter()
    {
        HtmlFragment = "<h1 style='color: #2a95d5;'>Content Header</h1>",
        DrawDividerLine = true,
    },
};

// Convert an image to a PDF with custom header
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, options: options);

// Export the PDF
pdf.SaveAs("imageToPdfWithHeader.pdf");
Imports IronPdf

Private imagePath As String = "meetOurTeam.jpg"

Private options As New ChromePdfRenderOptions() With {
	.HtmlHeader = New HtmlHeaderFooter() With {
		.HtmlFragment = "<h1 style='color: #2a95d5;'>Content Header</h1>",
		.DrawDividerLine = True
	}
}

' Convert an image to a PDF with custom header
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath, options:= options)

' Export the PDF
pdf.SaveAs("imageToPdfWithHeader.pdf")
$vbLabelText   $csharpLabel

더 복잡한 헤더 및 푸터 관련 요구 사항이 있다면, HTML 헤더 및 푸터에 대한 당사의 종합 가이드를 참고하시기 바랍니다. 더 체계적인 관리를 위해 이미지 기반 PDF에 페이지 번호를 추가할 수도 있습니다.

맞춤형 결과물은 어떻게 보이나요?

성능 및 대용량 이미지 컬렉션은 어떻게 처리해야 하나요?

대규모 이미지 컬렉션이나 고해상도 이미지를 다룰 때는 성능 향상을 위해 비동기 및 멀티스레딩 기법을 적용하십시오. Enterprise 애플리케이션의 경우, 상당한 작업 부하에서도 원활한 작동을 보장하기 위해 IronPDF의 성능 최적화 전략을 살펴보십시오.

또한, 클라우드 서비스에 저장된 이미지를 다룰 때는 원활한 클라우드 통합을 위해 Azure Blob Storage에서 이미지를 삽입하는 방법에 대한 가이드를 확인하시기 바랍니다.

PDF를 다시 이미지로 변환하려면 어떻게 해야 하나요?

PDF 문서를 이미지로 변환하거나 래스터화하려면, PDF를 이미지로 래스터화하는 방법에 대한 가이드를 참조하십시오.

다른 기능도 확인해 보시겠습니까? 여기에서 튜토리얼 페이지를 확인해 보세요: PDF 변환

자주 묻는 질문

PDF로 변환할 수 있는 이미지 형식은 무엇인가요?

IronPDF는 .bmp, .jpeg, .jpg, .gif, .png, .svg, .tif, .tiff, .webp, .apng, .avif, .cur, .dib, .ico, .jfif, .jif, .jpe, .pjp, .pjpeg 등 다양한 이미지 형식을 PDF 변환에 지원합니다. 여기에는 JPEG, PNG, BMP, GIF와 같은 래스터 형식뿐만 아니라 SVG 그래픽과 같은 벡터 형식도 포함됩니다.

C#에서 단일 이미지를 PDF로 변환하는 방법은 무엇인가요?

IronPDF를 사용하여 단일 이미지를 PDF로 변환하려면 ImageToPdfConverter 클래스의 정적 메서드인 ImageToPdf를 사용하십시오. 이미지 파일 경로만 제공하면 됩니다. 예를 들어, IronPdf.ImageToPdfConverter.ImageToPdf("path/to/image.png").SaveAs("imageToPdf.pdf")와 같이 한 줄로 이미지를 PDF 문서로 변환할 수 있습니다.

여러 이미지를 하나의 PDF 문서로 변환할 수 있나요?

네, IronPDF는 ImageToPdfConverter.ImageToPdf 메서드를 사용하여 여러 이미지 파일(JPG, PNG, TIFF)을 하나의 PDF 문서로 변환할 수 있습니다. 이 기능은 여러 이미지 파일을 하나의 정리되고 모든 플랫폼에서 읽을 수 있는 PDF 형식으로 결합해야 하는 디지털 포트폴리오, 프레젠테이션 또는 보고서 제작에 적합합니다.

이미지를 PDF로 변환할 때 사용할 수 있는 사용자 지정 옵션은 무엇입니까?

IronPDF는 이미지 배치 및 동작(페이지에 맞추기, 가운데 정렬, 자르기), 텍스트 및 HTML 머리글/바닥글 추가, 워터마크 적용, 사용자 지정 페이지 크기 설정, 배경 및 전경 오버레이 포함 등 다양한 사용자 지정 옵션을 제공합니다. 이러한 기능을 통해 이미지를 사용하여 전문가 수준의 PDF 문서를 만들 수 있습니다.

이미지를 PDF로 변환하는 기능은 어떤 플랫폼을 지원하나요?

IronPDF의 이미지-PDF 변환 기능은 Windows, macOS, Linux 플랫폼에서 원활하게 작동하여 다양한 개발 환경에 적합합니다. NuGet을 통해 설치하거나 Windows 설치 프로그램을 다운로드하여 원하는 플랫폼에서 바로 사용할 수 있습니다.

PDF로 변환할 때 이미지 배치를 어떻게 제어할 수 있나요?

IronPDF는 페이지에 맞추기, 페이지 중앙 배치, 페이지 자르기 등 다양한 이미지 배치 및 동작 옵션을 제공합니다. 이러한 이미지 내보내기 동작을 통해 최종 PDF 문서에서 이미지가 표시되는 방식을 정밀하게 제어하여 전문적인 시각 콘텐츠를 구현할 수 있습니다.

커티스 차우
기술 문서 작성자

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

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

검토자:
제프 프리츠
제프리 T. 프리츠
.NET 커뮤니티 팀의 수석 프로그램 관리자
제프는 .NET 및 Visual Studio 팀의 수석 프로그램 관리자이기도 합니다. 그는 .NET Conf 가상 컨퍼런스 시리즈의 총괄 프로듀서이며, 개발자를 위한 라이브 스트림 'Fritz and Friends'를 주 2회 진행하며 시청자들과 함께 기술에 대해 이야기하고 코드를 작성합니다. 제프는 Microsoft Build, Microsoft Ignite, .NET Conf, Microsoft MVP Summit 등 주요 Microsoft 개발자 행사를 위한 워크숍, 프레젠테이션 및 콘텐츠 기획을 담당합니다.
시작할 준비 되셨나요?
Nuget 다운로드 19,014,616 | 버전: 2026.5 just released
Still Scrolling Icon

아직도 스크롤하고 계신가요?

빠른 증거를 원하시나요? PM > Install-Package IronPdf
샘플을 실행하세요 HTML이 PDF로 변환되는 것을 지켜보세요.