New to Telerik Document Processing? Download free 30-day trial

First Steps

In this getting started guide, we create a simple application that uses the Telerik Document Processing libraries to create a DOCX document and then export it as a PDF file.

The Telerik Document Processing libraries that we use in this guide are UI-independent and cover all .NET technologies, from desktop and web to mobile. They can also be deployed in client, server-side and cloud apps.

Step 1: Installing on Your Computer

Since we distribute Telerik Document Processing libraries as an addition to several Telerik UI component bundles, chances are that the libraries are already installed on your system. In this case, all you need is to locate them. The table below provides links to the installation instructions for each of the Telerik UI component suites that give you access to the Telerik Document Processing libraries. If the standard installation of your Telerik UI component suite includes the Document Processing assemblies, the table also shows their default location.

Regardless of the Telerik UI components suite that you use, you can always get the Document Processing assemblies as NuGet packages from the Telerik NuGet server.

The improved Telerik NuGet v3 is now available at https://nuget.telerik.com/v3/index.json. The new v3 API is faster, lighter, and reduces the number of requests from NuGet clients. The old https://nuget.telerik.com/nuget server will be deprecated and we encourage our clients to switch to the v3 API and use https://nuget.telerik.com/v3/index.json to access it.

UI Components suite Installation instructions Default location of the Document Processing assemblies
UI for ASP.NET AJAX Installing Telerik UI for ASP.NET AJAX
  • C:\Program Files (x86)\Progress\Telerik UI for ASP.NET AJAX [version]\AdditionalLibraries\Bin40
  • C:\Program Files (x86)\Progress\Telerik UI for ASP.NET AJAX [version]\AdditionalLibraries\Bin45
UI for ASP.NET MVC Installing Telerik UI for ASP.NET MVC
  • C:\Program Files (x86)\Progress\Telerik UI for ASP.NET MVC [version]\dpl\net40
  • C:\Program Files (x86)\Progress\Telerik UI for ASP.NET MVC [version]\dpl\netstandard
UI for ASP.NET Core Installing Telerik UI for ASP.NET Core The Telerik Document Processing libraries are available as NuGet packages on the Telerik NuGet server: https://nuget.telerik.com/v3/index.json.
UI for Blazor Installing Telerik UI for Blazor The Telerik Document Processing libraries are available as NuGet packages on the Telerik NuGet server: https://nuget.telerik.com/v3/index.json.
UI for WPF Installing Telerik UI for WPF
  • C:\Program Files (x86)\Progress\Telerik UI for WPF [version]\Binaries
  • C:\Program Files (x86)\Progress\Telerik UI for WPF [version]\Binaries.NoXaml
UI for Silverlight Installing Telerik UI for Silverlight
  • C:\Program Files (x86)\Progress\Telerik UI for WPF [version]\Binaries\Silverlight
  • C:\Program Files (x86)\Progress\Telerik UI for WPF [version]\Binaries.NoXaml\Silverlight
UI for WinForms Installing Telerik UI for WinForms
  • C:\Program Files (x86)\Progress\Telerik UI for WinForms [version]\Bin40
  • C:\Program Files (x86)\Progress\Telerik UI for WinForms [version]\Bin50
  • C:\Program Files (x86)\Progress\Telerik UI for WinForms [version]\BinNetCore
UI for Xamarin Installing Telerik UI for Xamarin C:\Program Files (x86)\Progress\Telerik UI for Xamarin [version]\Binaries\Portable
UI for WinUI Installing Telerik UI for WinUI C:\Program Files (x86)\Progress\Telerik UI for WinUI [version]\DPL

Step 2: Creating Application with Visual Studio

As we are going to create a UI-Independent example, we will use a console project for this guide:

  • Open Microsoft Visual Studio and create a new console project.

Figure 1: Go to File > New > Project > Console App (.Net Framework) > Next > Create

Create Console Project

Step 3: Add a Telerik Document Processing Library to a Project

This sample application will use RadWordsProcessing. In this step, we must add the required assemblies.

  1. Reference the assemblies that provide the RadWordsProcessing functionality:

    • Telerik.Windows.Documents.Core.dll
    • Telerik.Windows.Documents.Flow.dll
    • Telerik.Windows.Zip.dll
  2. Reference the assemblies that allow you to export the content as Docx and PDF files:

    • Telerik.Windows.Documents.Flow.FormatProviders.Docx.dll
    • Telerik.Windows.Documents.Flow.FormatProviders.Pdf.dll

The Document Processing assemblies for .NET Core don't contain "Windows" in their names.

Step 4: Create a Document

Example 1: Create RadFlowDocument

Telerik.Windows.Documents.Flow.Model.RadFlowDocument document = new Telerik.Windows.Documents.Flow.Model.RadFlowDocument(); 
Telerik.Windows.Documents.Flow.Model.Editing.RadFlowDocumentEditor editor = new Telerik.Windows.Documents.Flow.Model.Editing.RadFlowDocumentEditor(document); 
editor.InsertText("Hello world!"); 
Dim document As Telerik.Windows.Documents.Flow.Model.RadFlowDocument = New Telerik.Windows.Documents.Flow.Model.RadFlowDocument() 
Dim editor As Telerik.Windows.Documents.Flow.Model.Editing.RadFlowDocumentEditor = New Telerik.Windows.Documents.Flow.Model.Editing.RadFlowDocumentEditor(document) 
editor.InsertText("Hello world!") 

Step 5: Export the Generated Document

Export the RadFlowDocument to DOCX

To export the document as a docx file, use DocxFormatProvider. Using the below code will create a provider instance and save a document with it. The document will be exported in the bin folder of your current project.

Example 2: Export RadFlowDocument to DOCX

using (Stream output = new FileStream("output.docx", FileMode.OpenOrCreate)) 
{ 
    Telerik.Windows.Documents.Flow.FormatProviders.Docx.DocxFormatProvider provider = new Telerik.Windows.Documents.Flow.FormatProviders.Docx.DocxFormatProvider(); 
    provider.Export(document, output); 
} 
Using output As Stream = New FileStream("output.docx", FileMode.OpenOrCreate) 
    Dim provider As Telerik.Windows.Documents.Flow.FormatProviders.Docx.DocxFormatProvider = New Telerik.Windows.Documents.Flow.FormatProviders.Docx.DocxFormatProvider() 
    provider.Export(document, output) 
End Using 

Export the RadFlowDocument to PDF

To export the document as a PDF file, use PdfFormatProvider. Example 3 shows how to export the RadFlowDocument created in Examples 1 to a file.

Example 3: Export RadFlowDocument to PDF

using (Stream output = File.OpenWrite("Output.pdf")) 
{ 
    Telerik.Windows.Documents.Flow.FormatProviders.Pdf.PdfFormatProvider providerPDF = new Telerik.Windows.Documents.Flow.FormatProviders.Pdf.PdfFormatProvider(); 
    providerPDF.Export(document, output); 
} 
Using output As Stream = File.OpenWrite("Output.pdf") 
    Dim providerPDF As Telerik.Windows.Documents.Flow.FormatProviders.Pdf.PdfFormatProvider = New Telerik.Windows.Documents.Flow.FormatProviders.Pdf.PdfFormatProvider() 
    providerPDF.Export(document, output) 
End Using 

Run the project and you should see something like this:

Figure 2: The final result

Exported files

Next Steps

Now that you have run your first project example with Telerik Document Processing Libraries, you may want to explore some additional features like clone, edit, merge, insert documents and more. Below you can find guidance on getting started with such tasks:

See Also

In this article
Not finding the help you need? Improve this article