IronPDF 사용하여 C#에서 새 PDF를 만드는 방법
IronPDF는 C# 개발자가 빈 PDF에 대한 PdfDocument 생성자를 사용하여 프로그램적으로 새 PDF 문서를 생성하고, 다양한 소스에서 기존 PDF를 가져오거나 HTML, 이미지, RTF, Markdown 및 XML을 PDF 형식으로 변환할 수 있게 합니다. IronPDF 비즈니스 보고서 작성, 송장 생성 또는 웹 콘텐츠에서 동적 문서 생성 등 어떤 용도로든 .NET 애플리케이션에서 PDF를 생성하는 데 필요한 도구를 제공합니다.
PdfDocument 생성자 API는 지원되는 런타임(.NET Framework 4.6.2+, .NET Core 3.1+, .NET 5 이상) 전반에 걸쳐 일관성을 유지하지만, 이전 런타임에서는 성능이 아래 벤치마크와 다를 수 있습니다.// 1. Install IronPDF from NuGet
// 2. Create a blank PDF
var pdf = new IronPdf.PdfDocument(270, 270);
// 3. Or convert HTML to PDF
var renderer = new IronPdf.ChromePdfRenderer();
var pdfFromHtml = renderer.RenderHtmlAsPdf("<h1>Hello PDF!</h1>");
// 4. Save your PDF
pdf.SaveAs("myNewPdf.pdf");' 1. Install IronPDF from NuGet
' 2. Create a blank PDF
Dim pdf As New IronPdf.PdfDocument(270, 270)
' 3. Or convert HTML to PDF
Dim renderer As New IronPdf.ChromePdfRenderer()
Dim pdfFromHtml As IronPdf.PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello PDF!</h1>")
' 4. Save your PDF
pdf.SaveAs("myNewPdf.pdf")-
1Install IronPDF with NuGet Package Manager
-
2다음 코드 조각을 복사하여 실행하세요.
new IronPdf.PdfDocument { DefaultPageSize = new IronPdf.PageSize(270,270) }.SaveAs("blankPage.pdf");C# -
3실제 운영 환경에서 테스트할 수 있도록 배포하세요.
무료 체험판으로 오늘 프로젝트에서 IronPDF 사용 시작하기
최소 워크플로우(5단계)
- 새로운 PDF 파일을 생성하려면 NuGet 에서 IronPDF 다운로드하세요.
- 빈 PDF를 생성하려면 PdfDocument 생성자를 사용하세요.
- 파일, URL, 바이트 배열 또는 JSON에서 기존 PDF를 가져옵니다.
- HTML, RTF, Markdown, 이미지, XML 등 다양한 형식을 PDF로 변환합니다.
- PDF 문서를 내보내기
빈 PDF 생성 예제
PDF 객체를 생성하는 방법에는 여러 가지가 있습니다. PDF의 너비와 높이만 알면 되는 가장 간단한 방법부터 시작해 보겠습니다. 이 PdfDocument 생성자는 사용자 정의 및 사용을 위한 새 빈 PDF를 생성합니다. 치수는 포인트 단위(1/72인치)로 지정되어 있어 라벨, 명함 또는 사용자 지정 문서 형식과 같은 다양한 용도에 맞게 정확한 크기로 조정할 수 있습니다.
페이지 크기를 더욱 세밀하게 제어해야 하는 개발자를 위해 IronPDF 사용자 지정 용지 크기 와 Letter, A4, Legal 크기를 포함한 다양한 사전 정의된 형식을 지원합니다. 페이지 방향 기능을 사용하여 다양한 방향을 설정할 수 있습니다.
빈 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")다양한 구성 환경에서의 PDF 생성 성능 비교
| 미터법 | 빈 A4 용지 | A4 + 메타데이터 | A4 (10페이지) | 레터 | 사용자 지정 (270×270) |
|---|---|---|---|---|---|
| 평균 작성 시간 | 266.6 ms | 279.4 ms | 287.2 ms | 262.4 ms | 280.6 ms |
| 출력 파일 크기 | 0.60 KB | 3.82 KB | 1.79 KB | 0.60 KB | 0.60 KB |
| 호출당 메모리 | 1.62 MB | 1.61 MB | 1.64 MB | 1.61 MB | 1.62 MB |
| 생성된 페이지 | 1 | 1 | 10 | 1 | 1 |
이러한 벤치마크 결과를 통해, 테스트된 모든 변형에서 평균 생성 시간이 약 260~290ms 이내로 유지된다고 안전하게 추론할 수 있습니다. 빈 PDF 파일을 만든 후에는 머리글과 바닥글을 추가하거나 , 워터마크를 적용하거나 , 이미지를 삽입하여 PDF를 향상시킬 수 있습니다.
파일에서 PDF를 가져오려면 어떻게 해야 하나요?
PDF를 수정하거나 변환하려면 먼저 PdfDocument 객체로 가져와야 합니다. PdfDocument 클래스의 정적 FromFile 메서드를 사용하여 이를 수행합니다. 동일한 클래스 내에서 JSON, 바이트 배열, 스트림 및 URL에서 PDF를 가져오는 것이 지원됩니다. 이러한 유연성은 여러 PDF 파일을 병합하거나 , 특정 페이지를 추출하거나, 기존 문서를 수정해야 하는 시나리오에 적합합니다.
IronPDF 클라우드 서비스에 저장된 PDF 파일을 처리할 때 Azure Blob Storage 및 기타 클라우드 플랫폼과 통합됩니다. 파일 시스템에 접근하지 않고도 효율적인 처리를 위해 메모리 스트림에서 PDF를 로드 할 수 있습니다.
사용 가능한 가져오기 방법은 무엇입니까?
using IronPdf;
PdfDocument pdf = PdfDocument.FromFile("sample.pdf");
pdf.SaveAs("export.pdf");Imports IronPdf
Private pdf As PdfDocument = PdfDocument.FromFile("sample.pdf")
pdf.SaveAs("export.pdf")가져오기 후에는 텍스트 및 이미지 추출 , 주석 추가 , 디지털 서명 적용 과 같은 다양한 작업을 수행할 수 있습니다.
다른 형식에서 어떻게 변환하나요?
이전의 PdfDocument 객체를 얻는 방법 외에도 다양한 형식을 PDF로 변환할 수 있습니다. 가장 정교한 방법은 HTML을 PDF로 변환하는 것인데, 이 방법은 Chrome 엔진을 사용하여 JavaScript, 이미지, 링크, CSS 스타일링을 포함한 모든 자산을 HTML과 함께 렌더링합니다. HTML 외에도 이미지, RTF, Markdown, XML 등 다른 형식의 파일도 PDF로 변환할 수 있습니다.
IronPDF의 Chrome 렌더링 엔진은 소스 콘텐츠의 시각적 충실도를 유지하는 픽셀 완벽한 변환을 보장합니다. 이 렌더러는 HTML5, CSS3 및 JavaScript 프레임워크를 포함한 최신 웹 표준을 지원하므로 복잡한 웹 페이지 또는 Razor 뷰를 PDF로 변환하는 데 적합합니다.
다음 코드 조각은 HTML을 PDF로 변환하는 방법을 보여줍니다. HTML 변환은 IronPDF의 렌더링 엔진을 사용하여 모든 스타일을 적용한 컨텐츠 무결성을 유지합니다. 마크다운을 PDF로 , XML을 PDF로 , 이미지를 PDF로 변환할 수도 있습니다.
어떤 렌더링 옵션을 설정해야 할까요?
using IronPdf;
// Instantiate Renderer
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.PaperFit.UseResponsiveCssRendering(1800);
renderer.RenderingOptions.WaitFor.RenderDelay(5000);
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
// Create a PDF from a URL or local file path
var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");
// Export to a file or Stream
pdf.SaveAs("url.pdf");Imports IronPdf
' Instantiate Renderer
Private renderer = New ChromePdfRenderer()
renderer.RenderingOptions.EnableJavaScript = True
renderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.PaperFit.UseResponsiveCssRendering(1800)
renderer.RenderingOptions.WaitFor.RenderDelay(5000)
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print
' Create a PDF from a URL or local file path
Dim pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/")
' Export to a file or Stream
pdf.SaveAs("url.pdf")어떤 파일 형식을 PDF로 변환할 수 있나요?
IronPDF 다양한 형식 간의 변환을 지원합니다.
- HTML을 PDF로 변환: HTML 문자열 , HTML 파일 또는 URL을 CSS 및 JavaScript 완벽하게 지원하며 PDF로 변환합니다.
- 이미지를 PDF로 변환: JPG, PNG, GIF, BMP, TIFF 이미지 변환
- 문서 형식 : DOCX 및 RTF 파일 변환
- 마크업 언어 : Markdown 및 XML 변환
- ASP.NET 페이지 : ASPX 및 Razor 페이지 변환
생성된 PDF 파일은 여기에 표시된 것처럼 내장된 PDF 뷰어를 사용하여 볼 수 있습니다. 아래 iframe에는 출력된 PDF 파일이 표시됩니다.
고급 시나리오의 경우 WebGL 사이트 렌더링 , JavaScript 지연 처리 또는 변환 문제 해결을 위한 사용자 지정 로깅 구현을 살펴보세요.
자주 묻는 질문
C#에서 PDF를 생성하기 위한 라이브러리를 어떻게 설치해야 하나요?
Visual Studio의 NuGet 패키지 관리자를 통해 IronPdf를 설치하십시오. NuGet 패키지 관리자 UI에서 'IronPDF'를 검색하거나 패키지 관리자 콘솔에서 'Install-Package IronPdf' 명령을 사용할 수 있습니다. 설치가 완료되면 PdfDocument 생성자나 ChromePdfRenderer 클래스를 사용하여 즉시 PDF 생성을 시작할 수 있습니다.
빈 PDF 문서를 가장 빠르게 만드는 방법은 무엇인가요?
IronPDF를 사용하여 빈 PDF를 만드는 가장 빠른 방법은 width 및 height 매개변수를 사용하여 PdfDocument 생성자를 호출하는 것입니다: new IronPdf.PdfDocument(270, 270).SaveAs('blank.pdf'). 크기는 포인트(인치의 1/72) 단위로 지정됩니다. 또한 사용자 지정 페이지 크기와 방향을 설정하고, 작성자 및 제목과 같은 메타데이터를 추가할 수도 있습니다.
HTML 콘텐츠를 PDF 형식으로 변환할 수 있나요?
네, IronPDF는 ChromePdfRenderer 클래스를 사용하여 HTML을 PDF로 변환하는 데 뛰어납니다. 단순히 렌더러 인스턴스를 생성하고 RenderHtmlAsPdf() 메소드를 사용하십시오: var renderer = new IronPdf.ChromePdfRenderer(); var pdf = renderer.RenderHtmlAsPdf('<h1>Hello PDF!</h1>'). 이것은 전체 HTML5, CSS3 및 JavaScript 렌더링을 지원합니다.
PDF로 변환할 수 있는 파일 형식은 무엇인가요?
IronPDF는 HTML, 이미지(JPG, PNG, GIF, BMP), RTF 문서, 마크다운 파일, XML 등 다양한 형식을 PDF로 변환하는 기능을 지원합니다. 각 형식에는 특정 메서드가 있습니다. 예를 들어, HTML의 경우 RenderHtmlAsPdf(), 이미지의 경우 ImageToPdf(), 그 외 형식의 경우 전용 렌더러를 사용합니다.
PDF 문서에 사용자 지정 메타데이터를 추가하려면 어떻게 해야 하나요?
IronPDF를 사용하여 PDFDocument를 생성한 후, MetaData 속성에 액세스하여 사용자 지정 정보를 설정합니다: pdf.MetaData.Author = '사용자 이름'; pdf.MetaData.Title = '문서 제목'; pdf.MetaData.CreationDate = DateTime.Now. 이 메타데이터는 문서 정리 및 검색 기능에 도움이 됩니다.
다른 소스에 있는 기존 PDF 파일을 가져올 수 있나요?
IronPDF를 사용하면 로컬 파일, URL, 바이트 배열 또는 JSON 데이터 등 다양한 소스의 기존 PDF를 가져올 수 있습니다. 로컬 파일의 경우 PdfDocument.FromFile(), 웹 기반 PDF의 경우 FromUrl(), 바이트 배열 데이터의 경우 FromBytes()를 사용하십시오. 이를 통해 기존 PDF 문서를 다루고 수정할 수 있습니다.
PDF 문서에 여러 페이지를 추가하려면 어떻게 해야 하나요?
PdfDocument 객체의 AppendPage() 메서드를 사용하여 빈 페이지를 동적으로 추가할 수 있습니다. IronPDF는 또한 특정 위치에 페이지 삽입, 다른 PDF에서 페이지 복사, 여러 PDF 문서 병합 기능도 지원합니다. 별도로 지정하지 않는 한, 새로 추가된 각 페이지는 기본 페이지 크기를 상속합니다.
지원되는 페이지 크기와 방향은 무엇입니까?
IronPDF는 Letter, A4, Legal과 같은 사전 정의된 용지 크기뿐만 아니라 포인트 단위로 지정한 사용자 지정 용지 크기도 지원합니다. 페이지 방향(세로 또는 가로)을 설정하고 다양한 용지 크기를 혼합하여 문서를 만들 수 있습니다. 사용자 지정 크기를 통해 라벨이나 명함과 같은 특수 용도에 맞게 정밀하게 용지 크기를 제어할 수 있습니다.
How fast is creating a blank PDF with IronPDF?
Creating a blank PDF with IronPDF is efficient, taking approximately 260-290 ms depending on the page dimensions and whether metadata or multiple pages are included.
Can IronPDF handle legacy HTML markup in conversions?
IronPDF, like other Chromium-based renderers, can encounter layout issues with legacy HTML. It's recommended to validate HTML before conversion for better results.
커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.
