Get started with .NET
This guide walks you through the steps to use a sample project, and then explains how to integrate the Toolbox add-on into your application with .NET.
Prerequisites
The Toolbox add-on for .NET requires .NET and .NET Core 2.0 or higher, or .NET Framework 4.6.1 or higher.
Getting started with a sample project
Learn how to use Toolbox add-on using a C# sample project and extract all images and image masks from a PDF document.
Compile and run the sample
- Visual Studio
- Command line
This sample describes the process using Visual Studio 2022.
Download a sample project, and then unzip the file.
In the sample folder, double click
ToolboxImageExtraction.csproj
In the
Program.cs
file, replace the string"insert-license-key-here"
with your license key:Sdk.Initialize("insert-license-key-here", null);
Click Build -> Build Solution to compile the project.
Run the compiled sample application. Provide
inputPath
for the input PDF file andoutputDir
path for the output directory where the image files will be stored:ToolboxImageExtraction <inputPath> <outputDir>
For example, to extract all images and image masks from the sample PDF file
ImageCollection.pdf
to the output directory/tmp/images
, run:ToolboxImageExtraction ImageCollection.pdf /tmp/images
Download a sample project, and then unzip the file.
In the
Program.cs
file, replace the string"insert-license-key-here"
with your license key:// Set and check license key. If the license key is not valid, an exception is thrown.
Sdk.Initialize("insert-license-key-here", null);In the sample folder, run the following command providing
inputPath
for the input PDF file andoutputDir
path for the output directory where the image files will be stored:dotnet run --framework net6.0 --project ToolboxImageExtraction.csproj <inputPath> <outputDir>
For example, to extract all images and image masks from the sample PDF file
ImageCollection.pdf
to the output directory/tmp/images
, run:dotnet run --framework net6.0 --project ToolboxImageExtraction.csproj ImageCollection.pdf /tmp/images
You can apply a similar procedure as described in this tutorial for other code samples. For more information, see Code samples page.
Integrate the Toolbox add-on into your application
Integrate and initialize the Toolbox add-on into your application by following the instructions in the next sections.
Add the Toolbox add-on to your project
- Visual Studio
- Command line
The integration section describes the process using Visual Studio 2022 on Windows.
- Open your solution in Visual Studio.
- Click Tools > Nuget Package Manager > Manage NuGet Packages for Solution....
- Click the Search tab and search for
PdfTools.Toolbox
. - Select the NuGet package named
PdfTools.Toolbox by PDF Tools AG
, select your Project, and then click Install. - Click OK to allow the changes, and then review and Accept the license agreement.
In the project directory, run the following command:
dotnet add package PdfTools.Toolbox
Optional: If you want to use a specific version of the Pdftools SDK, run the following command:
dotnet add package PdfTools.Toolbox --version <VERSION>
Initialize the SDK
After installing the Nuget package the final step before using the SDK is to initialize the SDK with your license key. Substitute the <PDFSDK,V1,include-your-key-here>
in the following method with the value of your license key:
PdfTools.Toolbox.Sdk.Initialize("<PDFSDK,V1,include-your-key-here>", null);
Without a valid license key the Toolbox add-on returns an error. Get in touch with the Pdftools sales team through the Contact page to get a full license.
Implement your use case
- Find more use cases and sample projects at the Toolbox add-on Code samples page.
- For more technical information about the Toolbox add-on for .NET, consult the .NET technical notes.