Developer Guide Leave feedback

Welcome to the Developer Guide for GroupDocs.Conversion Document Conversion Plugins. This section provides practical code examples to help you quickly integrate and use the conversion plugins in your own projects.

Before proceeding, please review the following topics:

• System Requirements: Covers supported platforms and prerequisites.
• Installation: Details the package installation process.

We recommend requesting a Temporary License to fully evaluate the conversion functionality without limitations.

Each example in this guide is provided as a self-contained code snippet. Instructions are provided below to help you run them in your development environment.

Alongside each code example, you’ll find downloadable input and output files:

• Source files are the input files used in the example.
• Output files are generated using a valid license and are free of evaluation watermarks.

Below is a walkthrough of how to run a sample code example using a basic PDF to DOCX scenario. The same approach applies to all other examples.

Open your terminal and run:

mkdir convert-pdf-to-docx
cd convert-pdf-to-docx

Use the .NET CLI to create a console application in your preferred language:

dotnet new console

dotnet new console -lang "VB"

dotnet new console -lang "F#"

Install the package via the .NET CLI:

dotnet add package GroupDocs.Conversion.LowCode

You can either copy your license file to the working directory or use license keys sent to you when you request or purchase a license.

This example (and others in this section) reads license keys from environment variables: GD_PUBLIC_KEY and GD_PRIVATE_KEY.

To set them:

set GD_PUBLIC_KEY=your_public_key
set GD_PRIVATE_KEY=your_private_key

$env:GD_PUBLIC_KEY = "your_public_key"
$env:GD_PRIVATE_KEY = "your_private_key"

export GD_PUBLIC_KEY="your_public_key"
export GD_PRIVATE_KEY="your_private_key"

Replace the contents of your Program file with the example code below.

using System;
using GroupDocs.Conversion.LowCode;

// Load license keys from environment variables
var publicKey = Environment.GetEnvironmentVariable("GD_PUBLIC_KEY");
var privateKey = Environment.GetEnvironmentVariable("GD_PRIVATE_KEY");

License.Set(publicKey, privateKey);

// Create a converter for an XLSX file
var converter = new XlsxToPdfConverter("cost-analysis.xlsx");

// Convert to PDF
converter.Convert("cost-analysis.pdf");

Imports System
Imports GroupDocs.Conversion.LowCode

Module Program
    Sub Main()
        Dim publicKey As String = Environment.GetEnvironmentVariable("GD_PUBLIC_KEY")
        Dim privateKey As String = Environment.GetEnvironmentVariable("GD_PRIVATE_KEY")

        License.Set(publicKey, privateKey)

        Dim converter As New XlsxToPdfConverter("cost-analysis.xlsx")
        converter.Convert("cost-analysis.pdf")
    End Sub
End Module

open System
open GroupDocs.Conversion.LowCode

[<EntryPoint>]
let main _ =
    let publicKey = Environment.GetEnvironmentVariable("GD_PUBLIC_KEY")
    let privateKey = Environment.GetEnvironmentVariable("GD_PRIVATE_KEY")

    License.Set(publicKey, privateKey)

    let converter = new XlsxToPdfConverter("cost-analysis.xlsx")
    converter.Convert("cost-analysis.pdf")
    0

Download the input file cost-analysis.xlsx and place it in the project folder.

Execute the app using:

dotnet run

After successful execution, cost-analysis.pdf should appear in the output folder.

You can also download the expected output to compare.

If something doesn’t work as expected:

• Ensure the environment variables are set correctly.
• Confirm that the input file is placed in the correct directory.
• For more help, visit the Technical Support page.