C#의 이미지에서 PDF로 변환하는 방법 [코드 예제 튜토리얼]

어떤 .NET Framework 버전을 선택해야 할까요?

IronPDF는 .NET Framework 4.6.2+, .NET Core 3.1+, .NET 5/6/7/8+를 포함한 다양한 .NET 버전을 지원합니다. 새 프로젝트의 경우 최적의 성능과 보안 업데이트를 위해 최신 LTS(Long Term Support) 버전의 .NET을 사용하는 것이 좋습니다. 이 라이브러리는 Windows, Linux, macOS 플랫폼에서도 원활하게 작동합니다.

다음으로, 이 프로젝트에서 IronPDF NuGet 패키지를 설치하여 기능을 사용하세요. IronPDF의 장점 중 하나는 독점 API에 의존하지 않고, PDF 문서 생성의 번거로움을 제거한다는 것입니다. HTML to PDF 렌더링은 HTML, JS, CSS, JPG, PNG, GIF, SVG와 같은 오픈 표준 문서 유형으로부터 픽셀 완벽한 PDF를 렌더링합니다. 간단히 말해, 이미 개발자들이 보유하고 있는 기술을 활용합니다.

다른 설치 방법은 무엇인가요?

IronPDF는 다음을 통해서도 설치할 수 있습니다:

• NuGet 패키지 관리자 UI: 프로젝트를 마우스 오른쪽 버튼으로 클릭하고 "NuGet 패키지 관리"를 선택한 후 "IronPdf"를 검색하고 설치를 클릭합니다
• 패키지 참조: @.csproj 파일에 <PackageReference Include="IronPdf" Version="*" /> 추가
• 직접 다운로드: IronPDF 웹사이트에서 DLL을 다운로드하여 수동으로 참조
• 명령줄: 터미널에서 dotnet add package IronPdf 사용

Azure 배포의 경우 추가 구성이 필요할 수 있습니다. 마찬가지로, Docker 환경도 특정 설정 단계가 필요합니다.

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

IronPDF는 다양한 이미지 형식의 PDF 변환을 지원합니다:

• JPEG/JPG: 사진에 가장 일반적인 형식
• PNG: 투명도가 있는 이미지에 이상적
• GIF: 애니메이션 GIF 포함(첫 프레임 사용)
• BMP: Windows 비트맵 형식
• TIFF: 다중 페이지 TIFF 파일 포함
• SVG: 스케일 가능 벡터 그래픽
• WebP: 현대적인 웹 이미지 형식

샘플 이미지

라이브러리를 사용하려면 program.cs 파일에서 IronPDF 라이브러리를 참조하세요. 파일 상단에 다음 코드 스니펫을 작성하세요:

using IronPdf;
using IronPdf.Imaging;
using System.Linq;

using IronPdf;
using IronPdf.Imaging;
using System.Linq;

Imports IronPdf
Imports IronPdf.Imaging
Imports System.Linq

다음으로, 메인 함수 안에 다음 코드를 작성하세요. 이는 JPG 파일을 PDF 파일로 변환합니다:

public static void Main(string[] args)
{
    // Convert a single image to the PDF document
    PdfDocument doc = ImageToPdfConverter.ImageToPdf(@"D:\Iron Software\ImageToPDF\bird.jpg", IronPdf.Imaging.ImageBehavior.CropPage);

    // Optional: Set document properties
    doc.MetaData.Author = "IronPDF Tutorial";
    doc.MetaData.Title = "Image to PDF Conversion";
    doc.MetaData.Subject = "Converting JPG to PDF";

    // Save the resulting PDF to the specified path
    doc.SaveAs(@"D:\Iron Software\ImageToPDF\bird.pdf");

    Console.WriteLine("PDF created successfully!");
}

public static void Main(string[] args)
{
    // Convert a single image to the PDF document
    PdfDocument doc = ImageToPdfConverter.ImageToPdf(@"D:\Iron Software\ImageToPDF\bird.jpg", IronPdf.Imaging.ImageBehavior.CropPage);

    // Optional: Set document properties
    doc.MetaData.Author = "IronPDF Tutorial";
    doc.MetaData.Title = "Image to PDF Conversion";
    doc.MetaData.Subject = "Converting JPG to PDF";

    // Save the resulting PDF to the specified path
    doc.SaveAs(@"D:\Iron Software\ImageToPDF\bird.pdf");

    Console.WriteLine("PDF created successfully!");
}

Public Shared Sub Main(args As String())
    ' Convert a single image to the PDF document
    Dim doc As PdfDocument = ImageToPdfConverter.ImageToPdf("D:\Iron Software\ImageToPDF\bird.jpg", IronPdf.Imaging.ImageBehavior.CropPage)

    ' Optional: Set document properties
    doc.MetaData.Author = "IronPDF Tutorial"
    doc.MetaData.Title = "Image to PDF Conversion"
    doc.MetaData.Subject = "Converting JPG to PDF"

    ' Save the resulting PDF to the specified path
    doc.SaveAs("D:\Iron Software\ImageToPDF\bird.pdf")

    Console.WriteLine("PDF created successfully!")
End Sub

ImageBehavior가 출력에 어떻게 영향을 미치나요?

위의 코드 예제에서 IronPDF가 제공하는 ImageToPdfConverter 클래스를 사용하여 이미지 변환을 수행합니다. ImageToPdf 메서드를 사용하여 이미지로부터 PDF 문서를 생성할 수 있습니다. 이 메서드는 이미지 파일과 System.Drawing 객체를 입력값으로 허용합니다.

정적 메서드 ImageToPdf 는 단일 이미지 파일을 동일한 치수의 PDF 문서로 변환합니다. 이는 두 가지 인수를 필요로 합니다: 이미지 경로 및 이미지 행동(이미지가 용지에 표시되는 방법). ImageBehavior 열거형은 여러 옵션을 제공합니다:

• CropPage: 이미지 치수에 맞게 PDF 페이지 크기 설정
• CenteredOnPage: 크기 조정 없이 페이지 중앙에 이미지 맞추기
• FitToPage: 페이지 여백 내에 이미지 맞추기
• FitToPageAndMaintainAspectRatio: 비율을 유지하며 크기 조정

Imaging.ImageBehavior.CropPage는 용지 크기를 이미지 크기와 동일하게 설정합니다. 기본 페이지 크기는 A4입니다. 다음 코드 라인을 통해 설정할 수 있습니다:

ImageToPdfConverter.PaperSize = IronPdf.Rendering.PdfPaperSize.Letter;

ImageToPdfConverter.PaperSize = IronPdf.Rendering.PdfPaperSize.Letter;

ImageToPdfConverter.PaperSize = IronPdf.Rendering.PdfPaperSize.Letter

특정 요구 사항에 대해 사용자 정의 페이지 크기를 설정할 수도 있습니다:

// Set custom page size in millimeters
ImageToPdfConverter.PaperSize = new IronPdf.Rendering.PdfPaperSize(210, 297);

// Set custom page size in millimeters
ImageToPdfConverter.PaperSize = new IronPdf.Rendering.PdfPaperSize(210, 297);

' Set custom page size in millimeters
ImageToPdfConverter.PaperSize = New IronPdf.Rendering.PdfPaperSize(210, 297)

어떤 용지 크기 옵션이 제공됩니까?

여러 페이지 크기 옵션이 제공되며 요구 사항에 따라 설정할 수 있습니다. IronPDF는 모든 표준 용지 크기를 지원합니다:

• A 시리즈: A0, A1, A2, A3, A4 (기본값), A5, A6, A7, A8, A9, A10
• B 시리즈: B0부터 B10까지
• US 크기: Letter, Legal, Ledger, Tabloid, Executive
• 기타: Foolscap, Crown, Demy, Royal 등

페이지 방향(세로 또는 가로)과 PDF용 사용자 정의 여백을 구성할 수도 있습니다.

다른 이미지 형식을 어떻게 필터링할 수 있나요?

위의 코드에서, System.IO.Directory.EnumerateFiles 는 지정된 폴더에 있는 모든 파일을 검색합니다. Where 절은 해당 폴더에서 모든 JPG 이미지를 필터링하여 imageFiles 컬렉션에 저장합니다. PNG 또는 다른 이미지 형식이 있는 경우 Where 쿼리에 추가할 수 있습니다:

// Filter multiple image formats
var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase) || 
                f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".png", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".bmp", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".gif", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".tiff", StringComparison.OrdinalIgnoreCase));

// Filter multiple image formats
var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase) || 
                f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".png", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".bmp", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".gif", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".tiff", StringComparison.OrdinalIgnoreCase));

' Filter multiple image formats
Dim imageFiles = System.IO.Directory.EnumerateFiles("D:\Iron Software\ImageToPDF\") _
    .Where(Function(f) f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase) OrElse _
                      f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase) OrElse _
                      f.EndsWith(".png", StringComparison.OrdinalIgnoreCase) OrElse _
                      f.EndsWith(".bmp", StringComparison.OrdinalIgnoreCase) OrElse _
                      f.EndsWith(".gif", StringComparison.OrdinalIgnoreCase) OrElse _
                      f.EndsWith(".tiff", StringComparison.OrdinalIgnoreCase))

또한 확장명의 배열을 사용하여 더 간결한 방법을 사용할 수 있습니다:

string[] imageExtensions = { ".jpg", ".jpeg", ".png", ".bmp", ".gif", ".tiff" };
var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
    .Where(f => imageExtensions.Any(ext => f.EndsWith(ext, StringComparison.OrdinalIgnoreCase)));

string[] imageExtensions = { ".jpg", ".jpeg", ".png", ".bmp", ".gif", ".tiff" };
var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
    .Where(f => imageExtensions.Any(ext => f.EndsWith(ext, StringComparison.OrdinalIgnoreCase)));

Dim imageExtensions As String() = {".jpg", ".jpeg", ".png", ".bmp", ".gif", ".tiff"}
Dim imageFiles = System.IO.Directory.EnumerateFiles("D:\Iron Software\ImageToPDF\") _
    .Where(Function(f) imageExtensions.Any(Function(ext) f.EndsWith(ext, StringComparison.OrdinalIgnoreCase)))

PDF에서 이미지가 어떤 순서로 나타날까요?

기본적으로 이미지들은 파일 시스템에서 반환된 순서로 나타나며, 이는 알파벳순이 아닐 수 있습니다. 순서를 제어하려면 파일을 정렬할 수 있습니다:

• 알파벳순: imageFiles.OrderBy(f => f)
• 생성 날짜별: imageFiles.OrderBy(f => new FileInfo(f).CreationTime)
• 파일 크기별: imageFiles.OrderBy(f => new FileInfo(f).Length)
• 사용자 정의 순서: 사용자 정의 비교 함수 사용

다음 줄은 모든 이미지를 취합하여 단일 PDF 문서로 결합합니다. 각 이미지는 PDF에서 별도의 페이지가 됩니다.

프린터 설정을 지정할 수 있나요?

Print 메서드는 PdfDocument 클래스에서 제공되며 기본 프린터를 사용하여 문서를 인쇄합니다. 프린터 이름과 다른 설정을 변경할 수 있는 옵션도 제공합니다. 고급 인쇄 옵션:

// Advanced printing with settings
using System.Drawing.Printing;

var printDocument = doc.GetPrintDocument();
printDocument.PrinterSettings.PrinterName = "Your Printer Name";
printDocument.PrinterSettings.Copies = 2;
printDocument.PrinterSettings.Collate = true;
printDocument.PrinterSettings.PrintRange = PrintRange.SomePages;
printDocument.PrinterSettings.FromPage = 1;
printDocument.PrinterSettings.ToPage = 3;

printDocument.Print();

// Advanced printing with settings
using System.Drawing.Printing;

var printDocument = doc.GetPrintDocument();
printDocument.PrinterSettings.PrinterName = "Your Printer Name";
printDocument.PrinterSettings.Copies = 2;
printDocument.PrinterSettings.Collate = true;
printDocument.PrinterSettings.PrintRange = PrintRange.SomePages;
printDocument.PrinterSettings.FromPage = 1;
printDocument.PrinterSettings.ToPage = 3;

printDocument.Print();

' Advanced printing with settings
Imports System.Drawing.Printing

Dim printDocument = doc.GetPrintDocument()
printDocument.PrinterSettings.PrinterName = "Your Printer Name"
printDocument.PrinterSettings.Copies = 2
printDocument.PrinterSettings.Collate = True
printDocument.PrinterSettings.PrintRange = PrintRange.SomePages
printDocument.PrinterSettings.FromPage = 1
printDocument.PrinterSettings.ToPage = 3

printDocument.Print()

문서 인쇄에 대한 자세한 내용은 이 PDF 인쇄 예제를 방문하세요. 기업 환경에서의 네트워크 인쇄 옵션도 탐색할 수 있습니다.

IronPDF에 대해 더 알아볼 수 있는 곳은?

IronPDF가 제공하는 여러 유용한 기능이 있습니다. 다음 리소스를 탐색하세요:

• 제품 개요를 위한 IronPDF 홈페이지 방문
• 자세한 안내를 위한 종합 문서 탐색
• 실용적인 사용을 위한 코드 예시 확인
• 단계별 학습을 위한 튜토리얼 읽기
• 기술 세부사항을 위한 API 참조 액세스
• 지원을 위한 IronPDF 커뮤니티 참여

특정 사용 사례를 위해 탐색하십시오: 웹 콘텐츠를 위한 HTML에서 PDF로 변환 보호를 위한 PDF 보안 기능 대규모 작업을 위한 성능 최적화 Azure 및 AWS에 대한 클라우드 배포 가이드

IronPDF의 가격은 얼마입니까?

IronPDF는 Iron Software suite의 일부입니다. IronXL을 통한 Excel 작업, IronBarcode를 통한 바코드 생성, IronOCR을 통한 텍스트 인식, IronWebscraper를 통한 웹 데이터 추출 등의 추가 유용한 제품들을 포함합니다. 완전한 Iron Suite를 구매하면 최대 250%까지 절약할 수 있으며, 현재 이 모든 다섯 가지 제품을 두 개의 가격으로 얻을 수 있습니다. 자세한 정보는 라이선스 세부 정보 페이지를 방문하세요.

IronPDF 제공:

• 테스트를 위한 무료 개발 라이선스
• $749부터 시작하는 전문 라이선스
• 로열티 없는 재배포 옵션
• SaaS 및 OEM 라이선스 가능
• 30일 환불 보장
• 1년 동안 무료 지원 및 업데이트

체험판 라이선스를 통해 30일 동안 IronPDF를 무료로 사용해보거나, 팀을 위한 라이선스 옵션을 탐색해보세요.