はじめる

翻訳：Bit Miracle。Sergey Bobrovsky によるオリジナル記事

2026年3月3日に更新されました

この記事では、Docotic.Pdf ライブラリを使用して .NET Core、ASP.NET、Windows Forms、WPF、Xamarin、Blazor、Unity、HoloLense アプリケーションで PDF ファイルを処理するための基本事項について説明します。

Docotic.Pdfライブラリのインストール

NuGetからのインストール

最も簡単な方法は、NuGet から BitMiracle.Docotic.Pdf パッケージをインストールする ことです。

NuGet マネージャーを初めて使用する場合は、こちらの クイック スタート記事 を参照してください。

手動でインストールする

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 を使用する

ライブラリによって提供される型の完全修飾名を入力しないようにするには、次の using ディレクティブを C# ソース ファイルに追加することをお勧めします。

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、その他のWeb形式からPDFを生成できます。

アドオンで提供される HTML から PDF への API の詳細については、機能の概要 をお読みください。この記事では、NuGetまたは手動でアドオンをインストールする方法について説明しています。サンプルコードも含まれています。

Layoutアドオン

Layoutアドオンを使用すると、構造化されたレイアウト要素からPDFを生成できます。テキスト範囲、画像、表、ヘッダー、フッター、コンテナ、そしてオプションで再利用可能なカスタムコンポーネントからドキュメントを作成すると、Layoutの洗練されたAPIがすべてを自動的に配置します。

要素を固定座標に配置する代わりに、コンテンツとページサイズの両方に合わせてレイアウトを調整する、簡潔で表現力豊かなAPIを用いて、ドキュメント全体をコードで記述します。レイアウトエンジンは、ページネーション、ネスト、複雑な構造を自動的に処理します。これにより、シンプルなページから洗練されたPDFレポートまで、あらゆるものを簡単に作成できます。

Layout API を使用して .NET で PDF を生成する 方法の詳細については、その機能について詳しく説明し、インストール手順とサンプル コードが含まれている記事をお読みください。

Gdiアドオン

PDFドキュメントを印刷したり、System.Drawing.GraphicsでPDFを描画したりできます。BitMiracle.Docotic.Pdf.GdiパッケージはNuGetからインストールできます。または、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ブログもぜひご覧ください。