Fluent syntax

Fluent syntax provides a compact notation for most typical actions of GroupDocs.Conversion for .NET API.

These actions include:

  • Loading files from various sources,
  • Configuring conversion settings,
  • Converting to the target format,
  • Saving converted files to various locations,
  • and so on.

Fluent syntax was introduced in version 22.1. and later reworked in version 23.6.

The fluent syntax is implemented by the FluentConverter class and several helper interfaces from the GroupDocs.Conversion.Fluent namespace.

The following code snippets show how to use the fluent syntax:

FluentConverter.Load("sample.docx")
    .ConvertTo("converted.pdf")
    .Convert();

FluentConverter.WithSettings(() => new ConverterSettings())
    .Load("sample.pdf").WithOptions(new PdfLoadOptions())
    .ConvertTo("converted.docx").WithOptions(new WordProcessingConvertOptions())
    .Convert();

//with v24.10 and later
FluentConverter.Load("sample.pdf").WithOptions(new PdfLoadOptions())
    .ConvertByPageTo((SavePageContext saveContext) => new FileStream($"converted-{saveContext.Page}.docx", FileMode.Create)).WithOptions(new WordProcessingConvertOptions())
    .Convert();

// before v24.10
FluentConverter.Load("sample.pdf").WithOptions(new PdfLoadOptions())
    .ConvertByPageTo((int page) => new FileStream($"converted-{page}.docx", FileMode.Create)).WithOptions(new WordProcessingConvertOptions())
    .Convert();

FluentConverter.Load("sample.pdf").GetPossibleConversions();
FluentConverter.Load("sample.pdf").GetDocumentInfo();
FluentConverter.Load("sample.pdf").WithOptions(new PdfLoadOptions()).GetPossibleConversions();
FluentConverter.Load("sample.pdf").WithOptions(new PdfLoadOptions()).GetDocumentInfo();