이 페이지에는 자동 번역된 텍스트가 포함될 수 있습니다.
시작하기
이 문서는 Docotic.Pdf 라이브러리를 사용하여 .NET Core, ASP.NET, Windows Forms, WPF, Xamarin, Blazor, Unity, HoloLens 애플리케이션에서 PDF 파일을 처리하는 데 필요한 몇 가지 기본 사항을 설명합니다.
Docotic.Pdf 라이브러리 설치하기
NuGet에서 설치하기
가장 쉬운 시작 방법은 NuGet에서 BitMiracle.Docotic.Pdf 패키지를 설치하는 것입니다.
NuGet Manager를 처음 사용한다면 이 빠른 시작 문서를 참조하세요.
수동으로 설치하기
사이트에서 Docotic.Pdf 라이브러리의 최신 릴리스를 다운로드하세요. 라이브러리는 ZIP 패키지로 배포됩니다. 패키지에는 Docotic.Pdf 라이브러리, 모든 샘플 코드 프로젝트, 라이브러리 추가 기능, 라이선스 계약이 포함되어 있습니다.
다운로드한 ZIP 패키지를 원하는 위치에 압축 해제하세요.
Visual Studio에서 참조 추가 대화 상자를 열고, ZIP 패키지를 압축 해제한 위치를 찾아가서 그곳의 DLL을 선택하세요.
샘플 코드 실행하기
Docotic.Pdf용 코드 샘플은 ZIP 패키지의 Samples 폴더에 있습니다. C# 언어로 작성된 샘플 코드를 사용하려면 SamplesCSharp 솔루션 파일을 여세요. VB.NET 버전은 SamplesVB.NET 솔루션 파일을 여세요.
GitHub의 샘플 코드 저장소에서 동일한 코드 샘플을 복제하거나 다운로드할 수 있습니다.
코드 샘플을 꼭 검토해 보세요. 애플리케이션에 PDF 처리 기능을 추가하는 데 도움이 됩니다.
.NET 프로젝트에서 Docotic.Pdf 사용하기
라이브러리가 제공하는 형식의 완전한 정규화 이름을 입력하지 않으려면, C# 소스 파일에 다음 using 지시문을 추가하는 것이 가장 좋습니다.
using BitMiracle.Docotic.Pdf;
VB.NET에서는 다음을 사용하세요.
Imports BitMiracle.Docotic.Pdf
C# 프로젝트에서는 다음 메서드를 애플리케이션 소스 코드에 추가하세요.
private static void helloPdf()
{
// string.Empty를 라이선스 키로 바꾸세요
BitMiracle.Docotic.LicenseManager.AddLicenseData(string.Empty);
string outputName = "hello.pdf";
// ASP.NET 애플리케이션에서는 대신 다음 줄을 사용하세요:
// string outputName = Server.MapPath("hello.pdf");
using (PdfDocument pdf = new PdfDocument())
{
// 첫 페이지에 "Hello world"를 그립니다
PdfPage firstPage = pdf.Pages[0];
firstPage.Canvas.DrawString(20, 20, "Hello world!");
pdf.Save(outputName);
}
// 저장된 문서를 기본 PDF 뷰어에서 엽니다
System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo() {
FileName = outputName,
UseShellExecute = true,
});
}
VB.NET 프로젝트에서는 다음 코드를 사용하세요.
Private Shared Sub helloPdf()
' string.Empty를 라이선스 키로 바꾸세요
BitMiracle.Docotic.LicenseManager.AddLicenseData(String.Empty)
Dim outputName As String = "hello.pdf"
' ASP.NET 애플리케이션에서는 대신 다음 줄을 사용하세요:
' Dim outputName As String = Server.MapPath("hello.pdf")
Using pdf As New PdfDocument()
' 첫 페이지에 "Hello world"를 그립니다
Dim firstPage As PdfPage = pdf.Pages(0)
firstPage.Canvas.DrawString(20, 20, "Hello world!")
pdf.Save(outputName)
End Using
' 저장된 문서를 기본 PDF 뷰어에서 엽니다
System.Diagnostics.Process.Start(
New ProcessStartInfo() With {
.FileName = outputName,
.UseShellExecute = True
}
)
End Sub
코드에서 helloPdf 메서드를 호출하세요. 그러면 hello.pdf 파일이 생성되고 기본 PDF 뷰어에서 열립니다.
애드온
무료 애드온으로 핵심 기능을 확장할 수 있습니다.
HtmlToPdf 애드온
HtmlToPdf 애드온을 사용하여 HTML을 PDF로 변환하세요. 이 애드온은 Google Chrome과 Blink 렌더링 엔진을 사용하므로 HTML5, CSS3, JavaScript 지원이 매우 뛰어납니다. 애드온을 사용해 HTML, SVG, WEBP 및 기타 웹 형식에서 PDF를 생성할 수 있습니다.
애드온이 제공하는 HTML to PDF API에 대한 자세한 내용은 기능 개요를 읽어보세요. 이 문서에서는 NuGet 또는 수동으로 애드온을 설치하는 방법을 설명합니다. 또한 샘플 코드도 포함되어 있습니다.
Layout 애드온
Layout 애드온을 사용하여 구조화된 레이아웃 요소에서 PDF를 생성하세요. 텍스트 스팬, 이미지, 표, 헤더, 푸터, 컨테이너, 그리고 필요에 따라 재사용 가능한 사용자 지정 구성 요소로 문서를 구성하면, 플루언트 Layout API가 모든 요소를 배치해 줍니다.
요소를 고정 좌표에 배치하는 대신, 간결하고 표현력 있는 API를 사용해 코드로 전체 문서를 설명하면 Layout이 콘텐츠와 페이지 크기에 맞게 레이아웃을 조정합니다. 그런 다음 레이아웃 엔진이 페이지 매김, 중첩, 복잡한 구조를 자동으로 처리합니다. 이 방식은 단순한 페이지부터 정교한 PDF 보고서까지 쉽게 만들 수 있게 해줍니다.
.NET에서 PDF 생성에 대한 자세한 내용은 Layout API의 기능을 심층적으로 설명하고 설치 방법과 샘플 코드를 포함한 문서를 읽어보세요.
Gdi 애드온
PDF 문서를 인쇄하거나 System.Drawing.Graphics에 PDF를 그릴 수 있습니다. NuGet에서 BitMiracle.Docotic.Pdf.Gdi 패키지를 설치할 수 있습니다. 또는 ZIP 패키지에서 다음 DLL에 대한 참조를 수동으로 추가하세요.
- BitMiracle.Docotic.Pdf.dll
- Gdi add-on/BitMiracle.Docotic.Pdf.Gdi.dll
Logging 애드온
PDF 문서의 내부 구조에 대한 정보를 기록하는 데 사용할 수 있습니다. NuGet에서 BitMiracle.Docotic.Pdf.Logging 패키지를 설치하세요. 또는 ZIP 패키지에서 다음 DLL에 대한 참조를 수동으로 추가하세요.
- BitMiracle.Docotic.Pdf.dll
- Logging add-on/BitMiracle.Docotic.Pdf.Logging.dll
- Logging add-on/Microsoft.Extensions.Logging.Abstractions.dll
결론
이제 Docotic.Pdf 라이브러리를 사용하여 애플리케이션에서 PDF 관련 기능을 개발할 수 있어야 합니다. 하지만 이것은 시작에 불과합니다. 라이브러리 기능에 대해 읽어보고 코드 샘플도 검토해 보시기 바랍니다. Bit Miracle 블로그도 확인해 보세요.