IronPDF 빠른 시작 가이드
IronPDF를 설치하고 단 5분 만에 첫 번째 PDF를 생성해 보세요. 간편한 API를 통해 HTML, DOCX, 이미지 등을 픽셀 단위까지 완벽한 PDF로 변환할 수 있습니다.
1. 필수 조건
- .NET Framework 4.6.2 이상 또는 .NET Core 3.1 이상 또는 .NET 5 이상
- Visual C++ Redistributable (for Windows).
2. IronPDF를 설치하세요
IronPDF의 표준 설치는 로컬에서 실행됩니다. Docker/마이크로서비스에 배포하려면, Remote Engine Mode Guide를 확인하세요.
-
1IronPDF를 NuGet Package Manager로 설치하십시오
-
2다음 코드 조각을 복사하여 실행하세요.
IronPdf.ChromePdfRenderer .StaticRenderHtmlAsPdf("<p>Hello World</p>") .SaveAs("pixelperfect.pdf");Dim Renderer = New IronPdf.ChromePdfRenderer() Renderer.StaticRenderHtmlAsPdf("<p>Hello World</p>").SaveAs("pixelperfect.pdf")Dim Renderer = New IronPdf.ChromePdfRenderer() Renderer.StaticRenderHtmlAsPdf("<p>Hello World</p>").SaveAs("pixelperfect.pdf") -
3실제 운영 환경에서 테스트할 수 있도록 배포하세요.
오늘 프로젝트에서 IronPDF 사용을 시작해보세요 무료 체험
IronPDF NuGet 라이브러리:로 이동하세요
- 솔루션 탐색기에서 참조를 마우스 오른쪽 버튼으로 클릭합니다.
- 'NuGet 패키지 관리' > '탐색' > IronPDF 검색을 선택하세요.
- IronPDF DLL 패키지 다운로드
- 사용 중인 운영체제에 맞는 ZIP 파일의 압축을 풀어 솔루션 디렉터리 내의 원하는 위치에 저장하세요.
- Visual Studio 솔루션 탐색기에서 '종속성'을 마우스 오른쪽 버튼으로 클릭합니다.
- '프로젝트 참조 추가' > '찾아보기'를 선택하여 압축 파일에서 추출한 모든 DLL을 포함시키세요.
플랫폼별 가이드
3. 라이선스 키 적용
IronPDF 라이선스를 구매하거나 30일 체험판을 시작하면, 라이선스 키가 이메일로 발송됩니다. 키를 복사하여 앱 시작 부분에 추가하세요.
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";Imports IronPdf
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY"Imports IronPdf
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY"4. 첫 번째 PDF 만들기
이 코드를 .cs 파일 맨 위에 추가하세요.
using IronPdf;using IronPdf;Imports IronPdfImports IronPdfPDF 개체를 만드는 가장 간단한 방법은 너비와 높이만 사용합니다. 이 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");Imports IronPdf
Dim pdf As New PdfDocument(270, 270)
pdf.SaveAs("blankPage.pdf")Imports IronPdf
Dim pdf As 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");using IronPdf;
IronPdf.ChromePdfRenderer
.StaticRenderHtmlAsPdf("<p>Hello World</p>")
.SaveAs("string-to-pdf.pdf");Dim Renderer = New IronPdf.ChromePdfRenderer()
Renderer.StaticRenderHtmlAsPdf("<p>Hello World</p>").SaveAs("string-to-pdf.pdf")Dim Renderer = New IronPdf.ChromePdfRenderer()
Renderer.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");using IronPdf;
DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");Imports IronPdf
Private renderer As New DocxToPdfRenderer()
Private pdf As PdfDocument = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx")
pdf.SaveAs("pdfFromDocx.pdf")Imports IronPdf
Private renderer As New DocxToPdfRenderer()
Private pdf As PdfDocument = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx")
pdf.SaveAs("pdfFromDocx.pdf")5. 더 고급 예제
IronPDF는 간단한 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");Imports IronPdf
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")
' Create text header
Dim textHeader As New TextHeaderFooter With {
.CenterText = "This is the header!"
}
' Create text footer
Dim textFooter As New TextHeaderFooter With {
.CenterText = "This is the footer!"
}
' Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader)
pdf.AddTextFooters(textFooter)
pdf.SaveAs("addTextHeaderFooter.pdf")Imports IronPdf
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")
' Create text header
Dim textHeader As New TextHeaderFooter With {
.CenterText = "This is the header!"
}
' Create text footer
Dim textFooter As New TextHeaderFooter With {
.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");using IronPdf;
PdfDocument pdf = PdfDocument.FromFile("novel.pdf");
// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");
pdf.SaveAs("redacted.pdf");Imports IronPdf
Private pdf As PdfDocument = PdfDocument.FromFile("novel.pdf")
' Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric")
pdf.SaveAs("redacted.pdf")Imports IronPdf
Private pdf As PdfDocument = 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");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");Imports IronPdf
Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>")
Private oldText As String = ".NET6"
Private newText As String = ".NET7"
' Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText)
pdf.SaveAs("replaceText.pdf")Imports IronPdf
Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>")
Private oldText As String = ".NET6"
Private newText As String = ".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를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.