多くのアプリケーションでは、.NET で PDF にテキストを追加して、ドキュメントに動的に注釈を付ける必要があります。
Conholdate.Total for .NET は、サーバーまたはデスクトップ上での PDF 操作を簡素化する包括的な SDK です。
このガイドでは、ライブラリのインストール方法、既存の PDF の読み込み、スタイル付きテキストの挿入、そして完全な実行可能コード例を使用した更新ファイルの保存方法を紹介します。

JavaでPDFにテキストを追加する要件

Javaベースのフロントエンドを構築する開発者は、バックエンドでPDFを変更できる .NET サービスが必要になることがよくあります。典型的な要件は次のとおりです：

  • 既存の PDF を読み込み、既存のコンテンツを失わないようにする。
  • 正確な座標にカスタムテキストを追加し、特定のフォントと色を指定する。
  • 元のレイアウトとメタデータを保持したまま、変更された PDF を保存する。

手動での編集や汎用的なコマンドラインツールでは、特に多数のファイルに対してプログラム的に操作を実行しなければならない場合、これらのニーズを自動化されたワークフローで満たすことはできません。

ジョブに Conholdate.Total for .NET を選択する

Conholdate.Total for .NET は、上記の要件に直接対応する豊富な PDF API セットを提供します。これにより、次のことが可能です：

  • 変換せずに PDF を開いて編集できます。
  • 完全なスタイル制御で TextFragment オブジェクトを作成します。
  • 任意のページの正確な位置にフラグメントを挿入します。
  • 単一のメソッド呼び出しで結果を保存します。

SDK は NuGet パッケージとして提供され、すべての .NET ランタイムで動作し、詳細なドキュメントと包括的なAPI リファレンスが含まれています。最新ビルドはリリースページからダウンロードできます。

ステップバイステップ ガイド: .NET で PDF にテキストを追加する

以下は、完全な例の後半で示されているコードと同様の実践的な手順です。

Install Conholdate.Total for .NET

まず、NuGet を使用して SDK をプロジェクトに追加します。

dotnet add package Conholdate.Total --version 25.10.0

バイナリはダウンロード URLから取得することもできます。

既存の PDF ドキュメントを読み込む

ソース PDF を指す Document インスタンスを作成します。

using GroupDocs.Pdf;

string inputPath = "input.pdf";

// Load the existing PDF document
using (Document pdfDocument = new Document(inputPath))
{
    // further processing...
}

Document クラスは、API リファレンスで説明されている PDF API の一部です。

テキスト フラグメントの作成と構成

TextFragment をインスタンス化し、その位置、フォント、色を設定します。

using GroupDocs.Pdf.Contents;
using GroupDocs.Pdf.Contents.Text;
using GroupDocs.Pdf.Contents.Fonts;

// Create a text fragment to insert
TextFragment textFragment = new TextFragment("Added text using Conholdate.Total for .NET");

// Set visual properties
textFragment.Position = new Position(100, 150); // X and Y coordinates in points
textFragment.Font = new Font("Arial", 12);
textFragment.Color = new Color(255, 0, 0); // Red color

この手順では、.NET ライブラリを使用した PDF へのテキスト挿入を、完全なスタイリングオプションとともに示します。

ページにテキストフラグメントを追加

対象ページ（この場合は最初のページ）を選択し、フラグメントを追加します。

// Ensure there is at least one page
Page page = pdfDocument.Pages.Count > 0 ? pdfDocument.Pages[0] : pdfDocument.Pages.Add();

// Add the text fragment to the page
page.Paragraphs.Add(textFragment);

このブロックを繰り返すことで、.NET の PDF ファイルにテキストを追加 を複数のページや位置に適用できます。

変更された PDF ドキュメントを保存

最後に、変更を新しいファイルに書き込みます。

string outputPath = "output.pdf";

// Save the modified PDF
pdfDocument.Save(outputPath);

SDK はすべての低レベル PDF 構造を処理するため、保存されたファイルは元のコンテンツに加えて新しい注釈を保持します。

完全サンプルコード: .NETでPDFにテキストを追加する

以下の例は、最初から最後までの全プロセスを示しています。

using System;
using GroupDocs.Pdf;
using GroupDocs.Pdf.Contents;
using GroupDocs.Pdf.Contents.Text;
using GroupDocs.Pdf.Contents.Fonts;

class Program
{
    static void Main()
    {
        string inputPath = "input.pdf";
        string outputPath = "output.pdf";

// Load the existing PDF document
        using (Document pdfDocument = new Document(inputPath))
        {
            // Ensure there is at least one page
            Page page = pdfDocument.Pages.Count > 0 ? pdfDocument.Pages[0] : pdfDocument.Pages.Add();

// Create a text fragment to insert
            TextFragment textFragment = new TextFragment("Added text using Conholdate.Total for .NET");

// Set visual properties
            textFragment.Position = new Position(100, 150); // X and Y coordinates in points
            textFragment.Font = new Font("Arial", 12);
            textFragment.Color = new Color(255, 0, 0); // Red color

// Add the text fragment to the page
            page.Paragraphs.Add(textFragment);

// Save the modified PDF
            pdfDocument.Save(outputPath);
        }

Console.WriteLine($"Text successfully added. Output saved to '{outputPath}'.");
    }
}

Note: このコード例はコア機能を示しています。プロジェクトで使用する前に、ファイルパスや設定値が実際の環境に合わせて更新されていることを確認し、必要な依存関係がすべて正しくインストールされていることを検証し、開発環境で十分にテストしてください。問題が発生した場合は、公式ドキュメントをご参照いただくか、サポートチームにお問い合わせください。

結論

.NET で PDF にテキストを追加するのは、Conholdate.Total for .NET の強力な機能を使えば簡単です。上記の手順に従うことで、ドキュメントを読み込み、スタイル設定された TextFragment を作成し、正確に配置し、数行のコードだけで結果を保存できます。本番環境での展開には有効なライセンスを適用することを忘れないでください。臨時ライセンスはライセンスページから取得でき、価格オプションは価格ページで確認できます。この基盤をもとに、複数行の注釈、動的データ挿入、PDF のバッチ処理などにアプローチを拡張できます。

FAQ

.NET ライブラリを使用して PDF にテキストを挿入するにはどうすればよいですか？

PDF API の TextFragment クラスを使用し、その Position、Font、Color を設定してから、ページの Paragraphs コレクションに追加します。完全なワークフローは上記のコード例に示されています。

.NETで既存のPDFにテキストを書き込む際、他のコンテンツを上書きせずに行えますか？

はい。SDKはPDFをその場で変更し、既存のページ、画像、注釈を保持しながら新しいテキストフラグメントを追加します。

PDF ファイルに複数ページにテキストを追加する最適な方法は何ですか？

Pages コレクションをループし、各ページに対して TextFragment を作成し、位置を設定してからページの Paragraphs に追加します。このアプローチは任意のページ数にスケールします。

続きを読む