이 페이지에는 자동 번역된 텍스트가 포함될 수 있습니다.

시작하기

이 문서에서는 Docotic.Pdf 라이브러리를 사용하여 WinForms, 콘솔 또는 ASP.NET 애플리케이션에서 PDF 파일을 처리하기 위해 시작하고 실행하는 데 필요한 몇 가지 기본 사항을 설명합니다.

Docotic.Pdf 시작하기

Docotic.Pdf 라이브러리 설치

NuGet에서 설치

시작하는 가장 쉬운 방법은 NuGet에서 BitMiracle.Docotic.Pdf 패키지를 설치하는 것입니다.

NuGet Manager를 처음 사용하는 경우 이 빠른 시작 문서를 참조하세요.

수동으로 설치

  1. 저희 사이트에서 Docotic.Pdf 라이브러리의 최신 릴리스를 다운로드하세요. 라이브러리는 ZIP 패키지로 배포됩니다.
    ZIP 패키지에는 두 가지 버전의 라이브러리가 포함되어 있습니다:
    • .NET 4.0 이상 프레임워크용 버전
    • .NET Standard 2.0 이상 프레임워크용 버전입니다.

    ZIP 패키지에는 모든 샘플 프로젝트와 라이센스 계약이 포함된 파일도 포함되어 있습니다.

  2. 다운로드한 ZIP 패키지를 원하는 위치에 추출합니다.

샘플 실행

Docotic.Pdf 샘플은 ZIP 패키지의 Samples 폴더에 있습니다. C# 언어로 작성된 샘플 코드를 사용하려면 SamplesCSharp 솔루션 파일을 엽니다. VB.NET 버전의 경우 SamplesVB.NET 솔루션 파일을 엽니다.

동일한 샘플 코드를 GitHub의 샘플 저장소에서 복제하거나 다운로드할 수 있습니다.

시간을 내어 샘플을 검토해 보시기 바랍니다. 이는 귀하의 응용 프로그램에 PDF 처리 기능을 추가하는 데 도움이 될 것입니다.

WinForms, 콘솔 또는 ASP.NET 애플리케이션에서 Docotic.Pdf 사용

  1. 비주얼 스튜디오 IDE를 엽니다. 새 프로젝트를 만들거나 기존 프로젝트를 엽니다.

  2. 참조 추가 대화 상자를 열고 BitMiracle.Docotic.Pdf.dll에 대한 참조를 추가합니다.

    • GAC에 라이브러리를 추가한 경우 확장 목록에는 BitMiracle.Docotic.Pdf 어셈블리가 포함됩니다.
    • 또는 ZIP 패키지를 추출한 위치를 찾아 거기에서 DLL을 선택할 수 있습니다.

참조 추가 대화 상자를 사용하여 Docotic.Pdf 추가

DLL을 수동으로 참조하는 대신 BitMiracle.Docotic.Pdf에 NuGet 참조를 추가할 수 있습니다.

System.Drawing 네임스페이스 및 GDI+의 유형과의 상호 운용성을 제공하는 메서드 및 속성에 액세스하려면 BitMiracle.Docotic.Pdf.Gdi 확장 DLL에 대한 참조를 추가해야 합니다. ZIP 패키지 또는 NuGet에서 BitMiracle.Docotic.Pdf.Gdi 패키지 설치에서 DLL을 찾을 수 있습니다.

HTML을 PDF로(또는 SVG를 PDF로) 변환하려면 BitMiracle.Docotic.Pdf.HtmlToPdf 확장 DLL에 대한 참조를 추가해야 합니다. DLL은 ZIP 패키지에도 있지만 DLL을 수동으로 추가하는 대신 NuGet에서 BitMiracle.Docotic.Pdf.HtmlToPdf 패키지를 설치하는 것이 좋습니다.

레이아웃 엔진을 사용하여 PDF 문서를 생성하려면 BitMiracle.Docotic.Pdf.Layout 확장 DLL에 대한 참조를 추가하세요. 엔진은 자동으로 콘텐츠를 페이지로 분할하고 페이지 머리글과 바닥글, 표 및 단락을 지원합니다. ZIP 패키지에서 DLL을 찾을 수 있지만 DLL을 수동으로 추가하는 대신 NuGet에서 BitMiracle.Docotic.Pdf.Layout 패키지를 설치하는 것이 좋습니다.

  1. dll에 대한 전체 참조를 입력하지 않으려면 C#에서 소스 파일의 기존 항목에 다음 using 문을 추가하는 것이 가장 좋습니다.
    using BitMiracle.Docotic.Pdf;
    

    VB.NET에서는 이것을 사용하십시오:

    Imports BitMiracle.Docotic.Pdf
    
  2. 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
  1. 코드에서 helloPdf() 메서드를 호출하세요. hello.pdf 파일이 생성되어 기본 PDF 뷰어에서 열립니다.

기본 PDF 뷰어의 hello.pdf

결론

이제 Docotic.Pdf 라이브러리를 사용하여 애플리케이션에서 PDF 관련 기능을 개발할 수 있습니다. 그러나 이것은 시작에 불과합니다. 라이브러리와 함께 제공되는 문서를 자세히 읽고 샘플을 검토해 보시기 바랍니다. Bit Miracle 블로그도 확인해 보세요.