GroupDocs.Conversion for .NET 24.5 Release Notes

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

Full list of changes in this release

Major features

• Converting embedded documents when convert WordProcessing, Presentation, and Spreadsheet documents
• Options to set columns and rows per page when convert from a Spreadsheet document
• Hyphenation when convert from a WordProcessing document
• Removing all JavaScript actions from the original PDF during conversion
• Configurable font embedding when converting to WebFileTypes

Public API and backward incompatible changes

1. In WordProcessingLoadOptions are introduced three new properties - ConvertOwner, ConvertOwned, and Depth
   
   Usage:

   const string source = "sample-ole.docx";
   using (var converter = new Converter(source, () => new WordProcessingLoadOptions
      {
          ConvertOwner = true,
          ConvertOwned = true,
          Depth = 1
      }))
   {
       var convertOptions = new PdfConvertOptions();
       converter.Convert("converted.pdf", convertOptions);
   }
   

2. In PresentationLoadOptions are introduced three new properties - ConvertOwner, ConvertOwned, and Depth
   
   Usage:

   const string source = "sample-ole.pptx";
   using (var converter = new Converter(source, () => new PresentationLoadOptions
      {
          ConvertOwner = true,
          ConvertOwned = true,
          Depth = 1
      }))
   {
       var convertOptions = new PdfConvertOptions();
       converter.Convert("converted.pdf", convertOptions);
   }
   

3. In SpreadsheetLoadOptions are introduced three new properties - ConvertOwner, ConvertOwned, and Depth
   
   Usage:

   const string source = "sample-ole.xlsx";
   using (var converter = new Converter(source, () => new SpreadsheetLoadOptions
      {
          ConvertOwner = true,
          ConvertOwned = true,
          Depth = 1
      }))
   {
       var convertOptions = new PdfConvertOptions();
       converter.Convert("converted.pdf", convertOptions);
   }
   

4. In SpreadsheetLoadOptions are introduced another two new properties - RowsPerPage, and ColumnsPerPage
   
   Usage:

   const string source = "sample.xlsx";
   using (var converter = new Converter(source, () => new SpreadsheetLoadOptions
      {
          RowsPerPage = 5,
          ColumnsPerPage = 5
      }))
   {
       var convertOptions = new PdfConvertOptions();
       converter.Convert("converted.pdf", convertOptions);
   }
   

5. In PdfLoadOptions is introduced a new property RemoveJavascript
   
   Usage:

   const string source = "source.pdf";
   
   using (var converter = new Converter(source, () => new PdfLoadOptions
      {
          RemoveJavascript = true,
      }))
   {
       var options = new PdfConvertOptions();
       converter.Convert("converted.pdf", options);
   }
   

6. In WordProcessingLoadOptions is introduced a new property HyphenationOptions which is from type HyphenationOptions with which can control the hyphenation behavior
   
   Usage:

   const string source = "sample.docx";
   using (var converter = new Converter(source, () => new WordProcessingLoadOptions
      {
          HyphenationOptions =
          {
              AutoHyphenation = true
          }
      }))
   {
       var convertOptions = new PdfConvertOptions();
       converter.Convert("converted.pdf", convertOptions);
   }
   

7. In EmailLoadOptions are introduced three new properties - DisplayAttachments, DisplaySent, and DisplaySubject
   
   Usage:

   const string source = "sample-with-attachment.eml";
   using (var converter = new Converter(source, (fileType) => new EmailLoadOptions
          {
              ConvertOwned = false,
              DisplayAttachments = false,
              DisplaySent = false,
              DisplaySubject = false
          }))
   {
       var options = new PdfConvertOptions();
       converter.Convert((FileType fileType) => new FileStream($"converted.pdf", FileMode.Create), options);
   }
   

8. In WebConvertOptions is introduced a new property EmbedFontResources
   
   Usage:

   const string source = "sample.docx";
   using (var converter = new Converter(source))
   {
       var convertOptions = new WebConvertOptions
       {
           FixedLayout = false,
           EmbedFontResources = true
       };
       converter.Convert("converted.html", convertOptions);
   }