Aspose.PDF for .NET 25.12

Improvements and Changes

Changes in .NET versions support

Since Aspose.PDF 25.12, we’ve added support for the latest .NET 10. At the same time, support for .NET 7 has ceased.

Features and Enhancements

The ability to create a logical structure from HTML tags has been added to meet accessibility requirements. This feature allows for creating tagged PDFs that are more accessible by defining reading order and marking up the content hierarchy. Set the HtmlLoadOptions.CreateLogicalStructure property to true to use this functionality.

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ConvertHtmlToPdfWithLogicalStructure()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Initialize HtmlLoadOptions
    Aspose.Pdf.HtmlLoadOptions options = new Aspose.Pdf.HtmlLoadOptions
    {
        // Convert HTML markup to PDF logical structure elements
        CreateLogicalStructure = true
    };

    // Open PDF document
    using (Aspose.Pdf.Document document = new Aspose.Pdf.Document(dataDir + "HTMLToPDF.html", options))
    {
        // Save PDF document
        document.Save(dataDir + "HtmlToPdfCreateLogicalStructure.pdf");
    }
}

A new capability to extract unsigned content from a digitally signed PDF has been introduced. This enhancement is implemented by the UnsignedContentAbsorber class, which detects changes to pages, form fields, annotations, and XForms that are not covered by a signature.

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ExtractUnsignedContent()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_SecuritySignatures();
    var inputPdfFile = dataDir + "input.pdf";

    // Open PDF document
    using (Document document = new Document(inputPdfFile))
    {
        // Create an instance of PdfFileSignature for working with signatures in the document
        using (PdfFileSignature signature = new PdfFileSignature(document))
        {
            // Create an instance of UnsignedContentAbsorber
            UnsignedContentAbsorber unsignedContent = new UnsignedContentAbsorber(signature);
            // Try to get unsigned content
            UnsignedContentAbsorber.Result result = unsignedContent.TryGetContent();

            // Print information about unsigned content
            Console.WriteLine(result.Message);
            Console.WriteLine(result.Coverage);
            Console.WriteLine(result.UnsignedContent.Pages.Count);
            Console.WriteLine(result.UnsignedContent.XForms.Count);
            Console.WriteLine(result.UnsignedContent.Forms.Count);
        }
    }
}

The Form Importer plugin has been implemented.

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void FormImporterPlugin()
{
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();
    var inputPdf = dataDir + "input.pdf";
    var inputJson = dataDir + "input.json";
    var outputPdf = dataDir + "output.pdf";
    
    var options = new FormImporterJsonOptions();
    options.AddInput(new FileDataSource(inputPdf), new FileDataSource(inputJson));
    options.AddOutput(new FileDataSource(outputPdf));

    var importer = new FormImporter();
    var result = importer.Process(options);
}

The Timestamp plugin has been implemented.

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void TimestampPlugin()
{
    var dataDir = RunExamples.GetDataDir_AsposePdf_SecuritySignatures();
    var inputPdf = dataDir + "input.pdf";
    var inputPfx = dataDir + "rsa_cert.pfx";
    var outputPdf = dataDir + "output.pdf";
    var timestampServerUrl = "http://timestamp.digicert.com";

    var options = new TimestampOptions(inputPfx, "12345")
    {
        ServerUrl = timestampServerUrl,
        BasicAuthCredentials = string.Empty
    };

    options.AddInput(new FileDataSource(inputPdf));
    options.AddOutput(new FileDataSource(outputPdf));

    using (var plugin = new Timestamp())
    {
        plugin.Process(options);
    }
}

Other notable enhancements

Bug Fixing and Other Changes

Public API and Backward Incompatible Changes

Added APIs

• Type: Aspose.Pdf.LowCode.FormImporter
• Type: Aspose.Pdf.LowCode.FormImporterJsonOptions
• Type: Aspose.Pdf.LowCode.FormJsonImportSource
• Type: Aspose.Pdf.LowCode.Timestamp
• Type: Aspose.Pdf.LowCode.TimestampOptions
• Type: Aspose.Pdf.Security.UnsignedContentAbsorber
• Type: Aspose.Pdf.Security.UnsignedContentAbsorber.Result
• Type: Aspose.Pdf.Security.UnsignedContentAbsorber.UnsignedContent
• Method: Aspose.Pdf.LowCode.FormImporter.#ctor System.Void
• Method: Aspose.Pdf.LowCode.FormImporter.Process(Aspose.Pdf.LowCode.IPluginOptions) Aspose.Pdf.LowCode.ResultContainer
• Method: Aspose.Pdf.LowCode.FormImporterJsonOptions.#ctor System.Void
• Method: Aspose.Pdf.LowCode.FormImporterJsonOptions.AddInput(Aspose.Pdf.LowCode.IDataSource,Aspose.Pdf.LowCode.IDataSource) System.Void
• Method: Aspose.Pdf.LowCode.FormImporterJsonOptions.AddOutput(Aspose.Pdf.LowCode.IDataSource) System.Void
• Method: Aspose.Pdf.LowCode.FormJsonImportSource.#ctor(Aspose.Pdf.LowCode.IDataSource,Aspose.Pdf.LowCode.IDataSource) System.Void
• Method: Aspose.Pdf.LowCode.Timestamp.#ctor System.Void
• Method: Aspose.Pdf.LowCode.Timestamp.Dispose System.Void
• Method: Aspose.Pdf.LowCode.Timestamp.Process(Aspose.Pdf.LowCode.IPluginOptions) Aspose.Pdf.LowCode.ResultContainer
• Method: Aspose.Pdf.LowCode.TimestampOptions.#ctor(System.IO.Stream,System.String) System.Void
• Method: Aspose.Pdf.LowCode.TimestampOptions.#ctor(System.String,System.String) System.Void
• Method: Aspose.Pdf.Security.UnsignedContentAbsorber.#ctor(Aspose.Pdf.Facades.PdfFileSignature) System.Void
• Method: Aspose.Pdf.Security.UnsignedContentAbsorber.TryGetContent Aspose.Pdf.Security.UnsignedContentAbsorber+Result
• Property: Aspose.Pdf.ExportFieldsOptions.FieldSelector System.Predicate`1[[Aspose.Pdf.Forms.Field, Aspose.PDF, Version=25.12.0.0, Culture=neutral, PublicKeyToken=716fcc553a201e56]]
• Property: Aspose.Pdf.HtmlLoadOptions.CreateLogicalStructure System.Boolean
• Property: Aspose.Pdf.LowCode.FormImporterJsonOptions.Inputs System.Collections.Generic.IReadOnlyList`1[[Aspose.Pdf.LowCode.FormJsonImportSource, Aspose.PDF, Version=25.12.0.0, Culture=neutral, PublicKeyToken=716fcc553a201e56]]
• Property: Aspose.Pdf.LowCode.FormImporterJsonOptions.Outputs System.Collections.Generic.List`1[[Aspose.Pdf.LowCode.IDataSource, Aspose.PDF, Version=25.12.0.0, Culture=neutral, PublicKeyToken=716fcc553a201e56]]
• Property: Aspose.Pdf.LowCode.FormJsonImportSource.JsonSource Aspose.Pdf.LowCode.IDataSource
• Property: Aspose.Pdf.LowCode.FormJsonImportSource.PdfSource Aspose.Pdf.LowCode.IDataSource
• Property: Aspose.Pdf.LowCode.TimestampOptions.BasicAuthCredentials System.String
• Property: Aspose.Pdf.LowCode.TimestampOptions.DigestHashAlgorithm Aspose.Pdf.DigestHashAlgorithm
• Property: Aspose.Pdf.LowCode.TimestampOptions.OperationName System.String
• Property: Aspose.Pdf.LowCode.TimestampOptions.PageNumber System.Int32
• Property: Aspose.Pdf.LowCode.TimestampOptions.Rectangle System.Drawing.Rectangle
• Property: Aspose.Pdf.LowCode.TimestampOptions.ServerUrl System.String
• Property: Aspose.Pdf.LowCode.TimestampOptions.SigContact System.String
• Property: Aspose.Pdf.LowCode.TimestampOptions.SigLocation System.String
• Property: Aspose.Pdf.LowCode.TimestampOptions.SigReason System.String
• Property: Aspose.Pdf.LowCode.TimestampOptions.Visible System.Boolean
• Property: Aspose.Pdf.Security.UnsignedContentAbsorber.Result.Coverage Aspose.Pdf.Signatures.SignaturesCoverage
• Property: Aspose.Pdf.Security.UnsignedContentAbsorber.Result.Message System.String
• Property: Aspose.Pdf.Security.UnsignedContentAbsorber.Result.Success System.Boolean
• Property: Aspose.Pdf.Security.UnsignedContentAbsorber.Result.UnsignedContent Aspose.Pdf.Security.UnsignedContentAbsorber+UnsignedContent
• Property: Aspose.Pdf.Security.UnsignedContentAbsorber.UnsignedContent.Annotations System.Collections.Generic.Dictionary`2[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089],[Aspose.Pdf.Annotations.Annotation, Aspose.PDF, Version=25.12.0.0, Culture=neutral, PublicKeyToken=716fcc553a201e56]]
• Property: Aspose.Pdf.Security.UnsignedContentAbsorber.UnsignedContent.Forms System.Collections.Generic.List`1[[Aspose.Pdf.Annotations.WidgetAnnotation, Aspose.PDF, Version=25.12.0.0, Culture=neutral, PublicKeyToken=716fcc553a201e56]]
• Property: Aspose.Pdf.Security.UnsignedContentAbsorber.UnsignedContent.Pages System.Collections.Generic.List`1[[Aspose.Pdf.Page, Aspose.PDF, Version=25.12.0.0, Culture=neutral, PublicKeyToken=716fcc553a201e56]]
• Property: Aspose.Pdf.Security.UnsignedContentAbsorber.UnsignedContent.XForms System.Collections.Generic.Dictionary`2[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089],[Aspose.Pdf.XForm, Aspose.PDF, Version=25.12.0.0, Culture=neutral, PublicKeyToken=716fcc553a201e56]]

Removed APIs

No removings.

Backward Incompatible Changes

• Support for .NET 7 ceased.