増分更新

増分更新は、元のコンテンツに影響を与えずに PDF ドキュメントを変更する方法です。ファイルの最後に変更を追加するだけなので、ドキュメント全体の書き直しに要する時間を節約できるだけでなく、データ損失のリスクを最小限に抑えることができます。この機能は、デジタル署名された PDF ドキュメントを更新する際に特に重要です。元の署名を無効にせずに、新しい署名をドキュメントに追加できます。

DioDocs for PDF では、Saveメソッドを使用して、変更されたドキュメントを増分更新して保存します。デフォルトでは、このメソッドは増分更新せずにドキュメントを保存します。ただし、Save メソッドの incrementalUpdate パラメータを true に設定することで、ドキュメントを追加保存できます。Saveメソッドは、パラメータとしてSaveMode列挙体を受け取る2つのオーバーロードが用意されます。SaveMode列挙体を使用して、PDFドキュメントをデフォルトモード、リニアライズドモード、または増分更新モードで保存できます。増分更新を含むドキュメントを保存するには、SaveMode列挙体をIncrementalUpdateに設定し、パラメータとしてSaveメソッドに渡すこともできます。メモ：リニアライズドモードと増分更新モードは相互に排他的なモードので、増分更新をリニアライズドされたドキュメントに含めることができません。リニアライズドモードの詳細については、「リニアライズドPDF」トピックを参照します。

さらに、DioDocs for PDFのSignメソッドを使用して、ドキュメントに署名した上、デフォルトで増分更新によってドキュメントを保存できます。または、SaveMode列挙体をIncrementalUpdateに設定し、パラメータとしてSignメソッドに渡すこともできます。これらの方法を使用すると、元の署名を無効にしたり、元のコンテンツを変更することなく、ドキュメントに複数回署名することができます。DioDocs for PDF では、署名後のドキュメントに 3 つのレベルで変更を行うことができます。

変更なし
フィールドの変更
フィールドの変更と注釈の追加

また、いったん署名されたドキュメントに新しいフィールドを追加すると、既存の署名が無効になることに注意してください。したがって、ドキュメントには、その後のすべての署名に対応できるだけの署名フィールドが既に存在している必要があります。DioDocs for PDFの有効なライセンスキーなしで署名されたPDFのサンプルを実行すると、生成されたPDFの元の署名は無効になります。これは、元の署名されたドキュメントを変更するような場合にライセンスヘッダがPDFに追加されるために発生します。

PDF の増分更新

PDF ファイルを増分更新するには

GcPdfDocument クラスのオブジェクトを作成します。
Load メソッドを使用して、既存の PDF ファイルをロードします。
ドキュメントを変更します。たとえば、テキストまたはグラフィック要素をドキュメントに追加します。
Save メソッドを使用し、増分更新パラメータを true に設定してドキュメントを保存します。

static void Main(string[] args)
{
    // FileStreamを使用して既存のPDFをロードします
    FileStream fileStream = File.OpenRead(args[0].ToString());
    GcPdfDocument doc = new GcPdfDocument();
    doc.Load(fileStream, null);

    const float In = 72;
    var tf = new TextFormat()
    {
        Font = StandardFonts.CourierItalic,
        FontSize = 12
    };

    doc.Pages[0].Graphics.DrawString
       ("追加更新のサンプルテキスト", tf, new PointF(In, In));

    doc.Save("IncUpdate", true);
}

複数の署名の追加

PDF ドキュメントに複数のデジタル署名を追加するには

SignatureProperties クラスを使用して、最初のデジタル署名証明書を設定します。
最初の署名を保持する SignatureField クラスを初期化します。
Add メソッドを使用して、PDF ドキュメントに署名フィールドを追加します。
署名フィールドを署名プロパティに接続します。
2 つ目の署名を保持する署名フィールドを追加します。
Sign メソッドを使用して、ドキュメントに署名します。
Load メソッドを使用して、署名したドキュメントをロードします。
2 つ目の署名用証明書を設定します。
ドキュメントに署名して、2 つ目の署名を組み込みます。

public class SignIncremental
{
    public void CreatePDF(Stream stream)
    {
        GcPdfDocument doc = new GcPdfDocument();

        // 署名されたドキュメントをロードします（SignDocサンプルに似たコードを使用しています）
        doc.Load(CreateAndSignPdf());

        // 2番目の証明書を初期化します
        var pfxPath = Path.Combine("Resources", "Misc", "JohnDoe.pfx");
        X509Certificate2 cert = new X509Certificate2(File.ReadAllBytes(pfxPath), "secret",
        X509KeyStorageFlags.MachineKeySet | X509KeyStorageFlags.PersistKeySet 
        | X509KeyStorageFlags.Exportable);
        SignatureProperties sp2 = new SignatureProperties()
        {
            Certificate = cert,
            Location = "GcPdfWeb Sample Browser",
            SignerName = "John Doe",
        };

        // ドキュメントに署名して保存します2番目の（まだ塗りつぶされていない）署名フィールドを探します
        var sfld2 = doc.AcroForm.Fields["SecondSignature"] as SignatureField;
        // 署名フィールドと署名プロパティに接続します
        sp2.SignatureField = sfld2 ?? throw new Exception
            ("Unexpected: could not find 'SecondSignature' field");

        // ドキュメントに署名して保存します
        // メモ:
        // - 署名と保存はアトミック操作であり、2つは分離できません。
        // - Sign()メソッドに渡されたストリームは読み込み可能でなければなりません。
        doc.Sign(sp2, stream);

        // ストリームを巻き戻し、作成したドキュメントを
        // 別のGcPdfDocumentに読み込み、署名を検証します。
        stream.Seek(0, SeekOrigin.Begin);
        GcPdfDocument doc2 = new GcPdfDocument();
        doc2.Load(stream);
        foreach (var fld in doc2.AcroForm.Fields)
            if (fld is SignatureField sfld)
                if (!sfld.Value.VerifySignature())
                    throw new Exception($"Failed to verify signature for field {sfld.Name}");

        // 完了しました。（生成および署名されたドキュメントはすでに 'stream'に保存されています）
    }

    // この方法は、DigitalSignatureサンプルとほぼ同じですが、
    // 2番目の署名フィールド（署名はしません）を追加します
    private Stream CreateAndSignPdf()
    {
        GcPdfDocument doc = new GcPdfDocument();
        Page page = doc.NewPage();
        TextFormat tf = new TextFormat() { Font = StandardFonts.Times, FontSize = 14 };
        page.Graphics.DrawString(
            "Hello, World!\r\nSigned below TWICE by GcPdfWeb SignIncremental sample" +
            ".\r\n(Note that some browser built-in viewers may not show the signatures.)",
            tf, new PointF(72, 72));

        // テスト証明書を初期化します
        var pfxPath = Path.Combine("Resources", "Misc", "GcPdfTest.pfx");
        X509Certificate2 cert = new X509Certificate2(File.ReadAllBytes(pfxPath), "qq",
        X509KeyStorageFlags.MachineKeySet | X509KeyStorageFlags.PersistKeySet 
        | X509KeyStorageFlags.Exportable);
        SignatureProperties sp = new SignatureProperties();
        sp.Certificate = cert;
        sp.Location = "GcPdfWeb Sample Browser";
        sp.SignerName = "GcPdfWeb";

        // 署名フィールドを初期化して、署名を保持します
        SignatureField sf = new SignatureField();
        sf.Widget.Rect = new RectangleF(72, 72 * 2, 72 * 4, 36);
        sf.Widget.Page = page;
        sf.Widget.BackColor = Color.LightSeaGreen;
        sf.Widget.TextFormat.Font = StandardFonts.Helvetica;
        sf.Widget.ButtonAppearance.Caption = $"Signer: {sp.SignerName}"+
            "\r\nLocation: {sp.Location}";
        // ドキュメントに署名フィールドを追加します
        doc.AcroForm.Fields.Add(sf);

        // 署名フィールドと署名プロパティに接続します
        sp.SignatureField = sf;

        // 2番目の証明書を追加します
        SignatureField sf2 = new SignatureField() { Name = "SecondSignature" };
        sf2.Widget.Rect = new RectangleF(72, 72 * 3, 72 * 4, 36);
        sf2.Widget.Page = page;
        sf2.Widget.BackColor = Color.LightYellow;
        // ドキュメントに署名フィールドを追加します
        doc.AcroForm.Fields.Add(sf2);

        var ms = new MemoryStream();
        doc.Sign(sp, ms);
        return ms;
    }

DioDocs for PDF を使用して PDF ドキュメントの増分更新を行う方法の詳細については、DioDocs for PDF サンプルブラウザを参照してください。