GroupDocs.Conversion for .NET 24.11 Release Notes

There are 20+ features, improvements, and bug fixes in this release.

Full list of changes in this release

Major features

• Avif Format Support: Added support for converting from the Avif image format.
• Improved Image Conversion Efficiency: Optimized image-to-document conversions (e.g., Word, PDF, Spreadsheet, Presentation) by reducing resource usage and increasing speed.
• Enhanced Spreadsheet Handling: Introduced formula calculation error suppression in SpreadsheetLoadOptions and added active sheet information retrieval in the SpreadsheetDocumentInfo class.
• Transparent Image Conversion: Added support for converting PDF documents to transparent PNG or TIFF image formats.
• Timeout and Cancellation Support: Implemented per-item timeout and cancellation tokens for recursive file conversion tasks, enabling better control over long-running processes.

Public API and backward incompatible changes

1. Introduced new property PreserveDocumentStructure in SpreadsheetLoadOptions class.

   Usage example:

   const string source = "balance.xlsx";
   
   using (var converter = new Converter(source, (LoadContext loadContext) => new SpreadsheetLoadOptions
      {
          PreserveDocumentStructure = true
      }))
   {
       var options = new PdfConvertOptions();
       converter.Convert("balance.pdf", options);
   }
   

2. Introduced new property PreserveDocumentStructure in PresentationLoadOptions class.

   Usage example:

   const string source = "presentation.pptx";
   
   using (var converter = new Converter(source, (LoadContext loadContext) => new PresentationLoadOptions
      {
          PreserveDocumentStructure = true
      }))
   {
       var options = new PdfConvertOptions();
       converter.Convert("presentation.pdf", options);
   }
   

3. Introduced new property IgnoreFormulaCalculationErrors in SpreadsheetLoadOptions class.

   Usage example:

   const string source = "balance.xlsx";
   
   using (var converter = new Converter(source, (LoadContext loadContext) => new SpreadsheetLoadOptions
      {
          IgnoreFormulaCalculationErrors = true
      }))
   {
       ...
   }
   

4. The ConvertContext class has been extended with a new CancellationToken property. This property allows users to control the timeout for each item during conversion. By setting a CancellationToken for individual items, users can effectively manage and cancel long-running conversions, providing greater flexibility and control over the conversion process.

5. The SaveContext and ConvertedContext classes have been enhanced with two new properties:

   • HierarchyLevel: Represents the depth level of the current item in a hierarchical structure, such as when processing container documents (e.g. emails with attachments, pst, ost, archives).
   • ItemIndex: Indicates the index of the current item within its hierarchy, providing a clear reference for tracking and processing individual items during conversions.

   These additions enable better context and control when handling complex or nested documents, making the conversion process more intuitive and manageable.