IronPDF 빠른 시작 가이드

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

IronPDF를 설치하고 단 5분 만에 첫 번째 PDF를 생성해 보세요. 간편한 API를 통해 HTML, DOCX, 이미지 등을 픽셀 단위까지 완벽한 PDF로 변환할 수 있습니다.

1. 필수 조건


2. IronPDF를 설치하세요

IronPDF의 표준 설치는 로컬에서 실행됩니다. Docker/마이크로서비스에 배포하려면 원격 엔진 모드 가이드를 참조하세요.

Nuget Icon지금 바로 NuGet을 사용하여 PDF 만들기를 시작하세요.

  1. NuGet 패키지 관리자를 사용하여 IronPDF를 설치하세요.

    PM > Install-Package IronPdf

  2. 다음 코드 조각을 복사하여 실행하세요.

    IronPdf.ChromePdfRenderer
           .StaticRenderHtmlAsPdf("<p>Hello World</p>")
           .SaveAs("pixelperfect.pdf");
  3. 실제 운영 환경에서 테스트할 수 있도록 배포하세요.

    지금 바로 무료 체험판을 통해 프로젝트에서 IronPDF를 사용해 보세요.
    arrow pointer
NuGet 패키지 관리자
DLL 다운로드

IronPDF NuGet 라이브러리로 이동하세요.

  1. 솔루션 탐색기에서 참조를 마우스 오른쪽 버튼으로 클릭합니다.
  2. 'NuGet 패키지 관리' > '찾아보기' > 'IronPdf' 검색을 선택합니다.
Install-Package IronPdf
  • IronPDF DLL 패키지 다운로드
  • 사용 중인 운영체제에 맞는 ZIP 파일의 압축을 풀어 솔루션 디렉터리 내의 원하는 위치에 저장하세요.
  • Visual Studio 솔루션 탐색기에서 '종속성'을 마우스 오른쪽 버튼으로 클릭합니다.
  • '프로젝트 참조 추가' > '찾아보기'를 선택하여 압축 파일에서 추출한 모든 DLL을 포함시키세요.

플랫폼별 가이드


3. 라이선스 키 적용

IronPDF 라이선스를 구매하시거나 30일 평가판을 선택하시면 라이선스 키가 이메일로 발송됩니다. 키를 복사하여 앱 시작 부분에 추가하세요.

IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
$vbLabelText   $csharpLabel

4. 첫 번째 PDF 만들기

이 코드를 .cs 파일 맨 위에 추가하세요.

using IronPdf;
using IronPdf;
$vbLabelText   $csharpLabel
빈 PDF 파일 생성
HTML 문자열을 PDF로 변환
DOCX 파일을 PDF로 변환

PDF 객체를 생성하는 가장 간단한 방법은 너비와 높이만 사용하는 것입니다. 이 PdfDocument 생성자는 사용자 정의가 가능한 빈 PDF를 생성합니다.

using IronPdf;

PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");
using IronPdf;

PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");
$vbLabelText   $csharpLabel

ChromePdfRenderer.RenderHtmlAsPdf 메서드를 사용하면 내장된 Chromium 엔진을 이용하여 모든 HTML(HTML5 포함)을 PDF로 변환할 수 있습니다.

using IronPdf;

IronPdf.ChromePdfRender
       .StaticRenderHtmlAsPdf("<p>Hello Word</p>")
       .SaveAs("string-to-pdf.pdf");
using IronPdf;

IronPdf.ChromePdfRender
       .StaticRenderHtmlAsPdf("<p>Hello Word</p>")
       .SaveAs("string-to-pdf.pdf");
$vbLabelText   $csharpLabel

DocxToPdfRenderer 클래스를 사용하면 Word 문서를 PDF로 변환할 수 있으며, DOCX 파일을 사용자 지정 가능한 PDF로 직접 렌더링하여 .NET 앱에 원활하게 통합할 수 있습니다.

using IronPdf;

DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");
using IronPdf;

DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");
$vbLabelText   $csharpLabel

5. 더 고급 예제

IronPDF는 간단한 PDF 생성 및 변환 기능 외에도 더욱 강력한 PDF 사용자 지정 옵션을 제공합니다.

머리글과 바닥글 추가
텍스트 수정
PDF 병합

TextHeaderFooter 인스턴스를 생성하고 텍스트를 추가한 다음 PDF에 첨부하여 텍스트 머리글 또는 바닥글을 만들 수 있습니다.

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);

pdf.SaveAs("addTextHeaderFooter.pdf");
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);

pdf.SaveAs("addTextHeaderFooter.pdf");
$vbLabelText   $csharpLabel

RedactTextOnAllPages 사용하면 문서 전체에서 특정 문구를 손쉽게 삭제할 수 있습니다.

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("novel.pdf");

// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");

pdf.SaveAs("redacted.pdf");
using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("novel.pdf");

// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");

pdf.SaveAs("redacted.pdf");
$vbLabelText   $csharpLabel

C#에서 Merge 메서드를 사용하여 두 PDF 파일을 병합할 수 있습니다. ReplaceTextOnAllPages 메서드를 사용하여 새 PdfDocument 모든 페이지에서 이전 텍스트를 새 텍스트로 바꿀 수 있습니다.

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");

string oldText = ".NET6";
string newText = ".NET7";

// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);

pdf.SaveAs("replaceText.pdf");
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");

string oldText = ".NET6";
string newText = ".NET7";

// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);

pdf.SaveAs("replaceText.pdf");
$vbLabelText   $csharpLabel

빠른 문제 해결

문제 해결책
Visual C++ 런타임이 누락되었습니다. Chrome 엔진에 필요한 Visual C++ 재배포 가능 패키지(x86 및 x64 버전 모두)를 설치하세요.
라이선스가 인식되지 않았습니다 `IronPdf.License.IsLicensed` 속성을 사용하여 라이선스가 적용되었는지 확인하십시오. IronPDF 작업을 시작하기 전에 라이선스가 적용되었는지 반드시 확인하십시오.
첫 번째 렌더링이 느립니다. 시작 시 `IronPdf.Installation.Initialize()` 호출하여 렌더링 엔진을 사전 초기화하십시오.
리눅스/Docker 종속성 종속성 자동 설치를 위해 `Installation.리눅스AndDockerDependenciesAutoConfig = true` 설정하십시오.

다음 단계


자주 묻는 질문

IronPdfEngine을 사용하여 원격으로 PDF를 생성하려면 어떻게 설정해야 하나요?

원격 PDF 생성을 위해 IronPdfEngine을 설정하려면 NuGet에서 `IronPdf.Slim` 패키지를 설치하고 `IronPdfConnectionConfiguration` 클래스를 사용하여 연결 설정을 구성하십시오. 이 설정을 통해 애플리케이션을 IronPdfEngine 인스턴스에 원격으로 연결할 수 있습니다.

IronPdfEngine을 애플리케이션과 함께 사용할 때의 주요 이점은 무엇입니까?

IronPdfEngine을 애플리케이션과 함께 사용하면 PDF 작업을 원격으로 실행할 수 있으므로 특히 구형 시스템 및 모바일 플랫폼에서 플랫폼별 호환성 문제를 방지하는 데 도움이 됩니다. 또한 실행 중에 .NET 런타임이 필요하지 않습니다.

PDF 기본 라이브러리 대신 IronPdfEngine을 사용하는 것을 선택할 수 있는 이유는 무엇일까요?

IronPdfEngine을 선택하면 성능 집약적인 PDF 기능을 원격으로 실행할 수 있으며, 이를 통해 다양한 운영 체제와의 호환성 문제를 줄이고 Chrome과 동일한 HTML-PDF 변환 렌더러를 활용하여 성능을 향상시킬 수 있습니다.

IronPdfEngine에서 수평 확대/축소가 지원되나요?

아니요, IronPdfEngine은 현재 수평 확장을 지원하지 않습니다. 즉, 서버 메모리에서 PDF 파일 바이너리가 처리되는 방식 때문에 여러 인스턴스에 걸쳐 로드 밸런싱이 불가능합니다.

IronPdfEngine은 다양한 운영 체제에서 실행될 수 있습니까?

IronPdfEngine은 Docker 컨테이너를 사용하여 Linux 시스템에서 실행되도록 설계되었습니다. 하지만 바이너리 파일은 플랫폼별로 다르므로 사용 중인 운영 체제에 맞는 버전을 사용해야 합니다.

IronPdfEngine을 사용할 때 PDF 출력 결과가 다르게 나오면 어떻게 해야 하나요?

운영 체제의 동작 방식에 따라 PDF 출력 결과가 약간씩 다를 수 있습니다. 차이를 최소화하려면 올바른 Docker 이미지를 사용하고 렌더링에 영향을 줄 수 있는 운영 체제별 설정을 확인하십시오.

내 애플리케이션이 올바른 버전의 IronPdfEngine을 사용하고 있는지 어떻게 확인할 수 있습니까?

호환성을 보장하기 위해 IronPDF의 각 버전에는 해당 버전의 IronPdfEngine이 필요합니다. 버전 간 문제를 방지하려면 두 구성 요소를 동시에 업데이트하십시오.

Windows에서 IronPdfEngine을 사용할 때의 제한 사항은 무엇입니까?

Windows에서 IronPdfEngine을 사용하려면 Docker용 Linux 컨테이너가 필요하며 서버 포트에 접근 가능한지 확인해야 합니다. 바이너리는 플랫폼별로 다르므로 Linux 컨테이너로 전환해야 합니다.

IronPDF가 원격 IronPDFEngine 서버에 연결되도록 구성하려면 어떻게 해야 합니까?

원격 서버에 대한 IronPDF를 구성하려면 `Installation.ConnectToIronPdfHost` `IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer` 메서드와 함께 사용하고 서버의 IP 주소와 포트 정보를 지정하십시오.

IronPdfEngine을 사용할 때 애플리케이션 크기를 최소화하려면 어떤 패키지를 사용해야 할까요?

IronPdfEngine을 사용하여 IronPDF를 실행하는 데 필요한 구성 요소만 포함되어 있으므로 애플리케이션 크기를 줄이려면 NuGet에서 `IronPdf.Slim` 패키지를 사용하는 것이 좋습니다.

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

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

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

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