IronPDF 빠른 시작 가이드

Curtis Chau
Curtis Chau
업데이트됨: 2026년 9월 17일

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

1. 필수 조건


2. IronPDF를 설치하세요

IronPDF의 표준 설치는 로컬에서 실행됩니다. Docker/마이크로서비스에 배포하려면, Remote Engine Mode Guide를 확인하세요.

  1. 1IronPDF를 NuGet Package Manager로 설치하십시오

    PM > Install-Package IronPdf

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

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

    오늘 프로젝트에서 IronPDF 사용을 시작해보세요 무료 체험
    arrow pointer
NuGet 패키지 관리자
DLL 다운로드

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

  1. 솔루션 탐색기에서 참조를 마우스 오른쪽 버튼으로 클릭합니다.
  2. 'NuGet 패키지 관리' > '탐색' > IronPDF 검색을 선택하세요.

PM > Install-Package IronPdf

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

플랫폼별 가이드


3. 라이선스 키 적용

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

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

4. 첫 번째 PDF 만들기

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

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

PDF 개체를 만드는 가장 간단한 방법은 너비와 높이만 사용합니다. 이 PdfDocument 생성자는 빈 PDF를 생성하며, 커스터마이징이 가능합니다.

using IronPdf;

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

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

using IronPdf;

IronPdf.ChromePdfRenderer
       .StaticRenderHtmlAsPdf("<p>Hello World</p>")
       .SaveAs("string-to-pdf.pdf");

DocxToPdfRenderer 클래스를 사용하여 워드 문서를 PDF로 변환합니다. 이 클래스는 DOCX 파일을 직접 커스터마이징 가능한 PDF로 렌더링하여 .NET 앱에 원활하게 통합할 수 있습니다.

using IronPdf;

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

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");

RedactTextOnAllPages를 사용하여 문서 전체에서 구문을 쉽게 삭제할 수 있습니다.

using IronPdf;

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

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

pdf.SaveAs("redacted.pdf");

C#에서 Merge 메소드를 사용하여 두 개의 PDF 파일을 병합합니다. 모든 PdfDocument에 ReplaceTextOnAllPages를 사용하여 오래된 텍스트를 새 텍스트로 교체하세요. 새로 생성되었거나 가져온 텍스트에 모두 적용 가능합니다.

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");

빠른 문제 해결

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

다음 단계


자주 묻는 질문

IronPDF를 어떻게 설치하나요?

IronPDF는 NuGet 패키지 관리자나 DLL 패키지를 다운로드하여 설치할 수 있습니다. 설치 가이드는 각각의 방법에 대한 단계를 자세히 설명하여 원활한 설치를 보장합니다.

IronPDF를 사용하려면 어떤 사전 요구 사항이 필요하나요?

IronPDF는 .NET Framework 4.6.2+, .NET Core 3.1+, 또는 .NET 5+가 필요합니다. 추가적으로, Windows에서는 Visual C++ Redistributable이 필요합니다.

IronPDF를 사용하여 HTML 문자열을 PDF로 변환하려면 어떻게 해야 하나요?

IronPDF는 ChromePdfRenderer.RenderHtmlAsPdf 메서드를 사용하여 HTML5를 포함한 HTML을 Chromium 렌더링을 통해 효율적으로 PDF로 변환합니다.

IronPDF는 Docker 환경에서 작동할 수 있나요?

네, IronPDF는 Docker 또는 마이크로서비스 아키텍처에 배포할 수 있습니다. 보다 자세한 내용은 IronPDF 설명서 사이트에 있는 원격 엔진 모드 가이드를 참조하세요.

IronPDF를 사용하여 빈 PDF를 생성하려면 어떻게 해야 하나요?

PdfDocument를 너비와 높이로 초기화하여 빈 문서를 설정하면 사용자 정의할 준비가 된 빈 PDF를 생성할 수 있습니다.

IronPDF는 어떤 추가적인 PDF 사용자 정의 옵션을 제공하나요?

IronPDF는 다양한 프로젝트 요구 사항에 맞춰 헤더 및 푸터 추가, 텍스트 수정, PDF 병합 등의 다양한 사용자 정의 기능을 제공합니다.

IronPDF에서 라이선스 키를 어떻게 적용하나요?

IronPDF 라이선스를 구매하거나 체험판을 시작하면 라이선스 키가 이메일로 전송됩니다. 이 키는 IronPdf.License.LicenseKey를 사용하여 응용 프로그램 시작 시 삽입합니다.

IronPDF 문제를 어떻게 해결할 수 있나요?

Visual C++ 런타임 누락이나 인식되지 않는 라이선스와 같은 일반적인 문제에는 필수 구성 요소 설치나 코드 실행 초기에 라이선스 적용 확인과 같은 구체적인 해결책이 있습니다.

IronPDF는 DOCX 파일을 PDF로 변환할 수 있나요?

네, IronPDF의 DocxToPdfRenderer 클래스를 사용하여 DOCX 파일을 PDF로 원활하게 변환할 수 있으며, 이는 .NET 응용 프로그램의 통합 기능을 향상시킵니다.

IronPDF를 사용하여 PDF 파일을 병합하는 가장 쉬운 방법은 무엇인가요?

IronPDF에서 제공하는 Merge 메서드를 사용하여 C# 응용 프로그램에서 여러 문서를 손쉽게 결합할 수 있습니다.

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

더 읽기

시작할 준비 되셨나요?

NuGet 다운로드 수 22,198,312버전:2026.11방금 출시