はじめに

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

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

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

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

NuGet からのインストール

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

NuGet Manager を初めて使う場合は、このクイックスタート記事を参照してください。

手動でインストール

サイトから 最新リリースをダウンロード してください。ライブラリは ZIP パッケージとして配布されています。パッケージには、Docotic.Pdf library、すべてのサンプルコード プロジェクト、ライブラリのアドオン、およびライセンス契約が含まれています。

ダウンロードした ZIP パッケージを任意の場所に展開します。

Visual Studio で Add Reference ダイアログを開き、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、その他の Web 形式から PDF を生成できます。

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

Layout アドオン

Layout アドオンを使用すると、構造化されたレイアウト要素から PDF を生成できます。文書はテキスト スパン、画像、表、ヘッダー、フッター、コンテナー、さらに必要に応じて再利用可能なカスタム コンポーネントから構成でき、流れるような Layout API がすべてを配置します。

要素を固定座標に配置する代わりに、内容とページ サイズの両方に適応する、明快で表現力のある API を使って文書全体をコードで記述します。その後、レイアウト エンジンがページ分割、入れ子、複雑な構造を自動的に処理します。これにより、単純なページから高度な PDF レポートまで、さまざまな出力を簡単に作成できます。

Layout API を使った .NET での PDF 生成 の詳細については、機能を詳しく説明し、インストール手順とサンプルコードも含む記事をお読みください。

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 blog もぜひご覧ください。