GroupDocs.Conversion for .NET 23.6 Release Notes

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

Full list of changes in this release

Key	Category	Summary
CONVERSIONNET‑6152	Enhancement	Improve boot-up performance
CONVERSIONNET‑6127	Enhancement	Expose FluentConverter explicitly and separate it from the main converter class
CONVERSIONNET‑6125	Enhancement	Extend DocumentCompleted delegate with source filename and target file type
CONVERSIONNET‑4058	Enhancement	Set landscape mode when converting HTML to PDF
CONVERSIONNET‑6046	Fix	Generated HTML does not appear good in IOS (e.g. Safari)
CONVERSIONNET‑6000	Fix	Exception when converting XLSM to PNG in .NET

Major features

Improved boot-up performance
Expose FluentConverter for explicit fluent syntax
Extended DocumentCompleted delegate with source fileName and target file type
Fixed conversions from XLSM to PNG

Public API and backward incompatible changes

The following methods of the Converter class are now obsolete and will be removed in v23.9

public void Convert(Func<Stream> document, Action<Stream, string> documentCompleted, ConvertOptions convertOptions)

public void Convert(Func<Stream> document, Action<Stream, string> documentCompleted, Func<string, FileType, ConvertOptions> convertOptionsProvider)

public void Convert(Func<FileType, Stream> document, Action<Stream, string> documentCompleted, ConvertOptions convertOptions)

public void Convert(Func<FileType, Stream> document, Action<Stream, string> documentCompleted, Func<string, FileType, ConvertOptions> convertOptionsProvider)

The changes are in the documentCompleted delegate.

It has changed from Action<Stream, string> to Action<string, FileType, Stream>. The parameters are respectively source file name, target file type, and converted stream.

The following methods of the Converter class are now obsolete and will be removed in v23.9

public void Convert(Func<int, Stream> document, Action<int, Stream, string> documentCompleted, ConvertOptions convertOptions)

public void Convert(Func<int, Stream> document, Action<int, Stream, string> documentCompleted, Func<string, FileType, ConvertOptions> convertOptionsProvider)

public void Convert(Func<int, FileType, Stream> document, Action<int, Stream, string> documentCompleted, ConvertOptions convertOptions)

public void Convert(Func<int, FileType, Stream> document, Action<int, Stream, string> documentCompleted, Func<string, FileType, ConvertOptions> convertOptionsProvider)

The changes are in the documentCompleted delegate.

It has changed from Action<int, Stream, string> to Action<string, FileType, int, Stream>. The parameters are respectively source file name, target file type, page number that is converted, and converted stream.

All fluent methods are removed from the Converter class.

Introduced a new FluentConverter class which allows fluent conversion setup.

Fluent syntax before v23.6:

new GroupDocs.Conversion.Converter()
  .Load("sample.pdf")
  .ConvertTo("converted.doc").WithOptions(new WordProcessingConvertOptions  
  {  
    Format = WordProcessingFileType.Doc  
  })
  .Convert();

Fluent syntax from v23.6 and greater:

FluentConverter
  .Load("sample.pdf")
  .ConvertTo("converted.doc").WithOptions(new WordProcessingConvertOptions  
  {  
    Format = WordProcessingFileType.Doc  
  })
  .Convert();