Syncfusion is excited to share that Word-to-PDF conversion is now available in Xamarin and .NET Core platforms.
Cross-platform development is the future of mobile, desktop, and web application development. It provides benefits like quick deployment, lower costs, wider reach, and quick turnaround time. The adoption of cross-platform application development is increasing among enterprises and small businesses as well. The Xamarin and .NET Core platforms are being used by large numbers of developers to develop applications that target multiple platforms.
Syncfusion already provided the ability to convert Word documents to PDF in Windows Forms, WPF, ASP.NET, and ASP.NET MVC applications, but it was not extended to Xamarin and .NET Core due to the lack of a graphical API.
From the 2018 Volume 1 release (version 16.1.0.24) onwards, Syncfusion has extended the support for converting Word documents to PDF in Xamarin and .NET Core with the help of the SkiaSharp graphics library.
Currently, the following features are available in Word-to-PDF conversion:
Let’s learn how to convert a Word document to PDF in the Xamarin platform.
For Windows
For macOS
1. Create a Cross-Platform App (Xamarin.Forms) and name it WordtoPDFdemo.
2. Select the Blank App template and the .NET Standard option under Code Sharing Strategy.
3. Right-click the .NET Standard project, select Properties, and set the Target framework of the application as .NET Standard 1.4 or higher.
4. Add the Syncfusion.Xamarin.DocIORenderer NuGet package as a reference to the .NET Standard project in your Xamarin application.
Note: Syncfusion Xamarin components are available on nuget.org.
5. Add the input Word document to the asset folder in the .NET Standard project. Right-click the Word document, select Properties, and set its build action as Embedded resource.
6. Add a button in the MainPage.xaml file.
<!--?xml version="1.0" encoding="utf-8" ?-->
<contentpage x_class="WordToPDF.MainPage">
<stacklayout padding="10">
<label x_name="Content_heading" text="Word to PDF in XForms" fontsize="Large" fontattributes="Bold" horizontaloptions="Center" verticaloptions="Center"></label>
<label x_name="Content_1" text="This sample demonstrates how to convert a Word Document to PDF using DocIORenderer." fontsize="Medium" verticaloptions="Center"></label>
<button x_name="btnGenerate" clicked="OnButtonClicked" text="Convert to PDF" horizontaloptions="Center" verticaloptions="Center" tabindex="151"></button>
</stacklayout>
</contentpage>
7. Add the following code in the onButtonClicked method in the MainPage.xaml.cs file. Use the ConvertToPDF method of the DocIORenderer class to convert the WordDocument instance to a PdfDocument instance and save the PDF document to the device.
Assembly assembly = typeof(App).GetTypeInfo().Assembly;
// Retrieves the document stream from embedded Word document
Stream inputStream = assembly.GetManifestResourceStream("WordToPDF.Assets.GettingStarted.docx");
string fileName = "GettingStarted.pdf";
// Creates new instance of WordDocument
WordDocument wordDocument = new WordDocument(inputStream, Syncfusion.DocIO.FormatType.Automatic);
// Creates new instance of DocIORenderer for Word to PDF conversion
DocIORenderer render = new DocIORenderer();
// Converts Word document into PDF document
PdfDocument pdfDocument = render.ConvertToPDF(wordDocument);
// Releases all resources used by the DocIORenderer and WordDocument instance
render.Dispose();
wordDocument.Close();
// Saves the converted PDF file
MemoryStream outputStream = new MemoryStream();
pdfDocument.Save(outputStream);
// Releases all resources used by the PdfDocument instance
pdfDocument.Close();
// Saves the PDF document to the device through the dependency service with the help of platform-specific file system API
if (Device.OS == TargetPlatform.WinPhone || Device.OS == TargetPlatform.Windows)
DependencyService.Get<isavewindowsphone>().Save(fileName, "application/pdf", outputStream);
else
DependencyService.Get<isave>().Save(fileName, "application/pdf", outputStream);
A runnable Xamarin application capable of Word to PDF conversion can be downloaded here.
Next, let’s learn how to convert a Word document to PDF in an ASP.NET Core application.
Windows
macOS
Linux
1. Create a new ASP.NET Core Web Application project using Core 1.0 or newer and name it WordtoPDFdemo.
2. Set ASP.NET Core 2.0 as the target platform and select the Web Application (Model-View-Controller) project template.
3. Add the Syncfusion.DocIORenderer.NetStandard NuGet package as a reference to the ASP.NET Core project from the Syncfusion ASP.NET Core NuGet feed. For more information about adding a NuGet feed in Visual Studio and installing NuGet packages, refer to our documentation.
You can also install this package from the NuGet package manager console by executing the following command.
| > Install-package Syncfusion.DocIORenderer.NetStandard -source https://nuget.syncfusion.com/nuget_aspnetcore/nuget/getsyncfusionpackages/aspnetcore |
4. Add the following code in the index.cshtml file.
@{
ViewData["Title"] = "Home Page";
}
@{Html.BeginForm("Index", "Home", FormMethod.Post, new { enctype = "multipart/form-data" });
{
<div class="Common">
<div class="tablediv">
<div class="rowdiv">
This sample illustrates how to convert a Word document to PDF using Essential DocIO and Essential PDF.
</div>
<div class="rowdiv" style="border-width: 0.5px;border-style:solid; border-color: lightgray; padding: 1px 5px 7px 5px">
Click the button to view the resultant PDF document converted from a Word document using Essential DocIO and Essential PDF. Please note that a PDF viewer is required to view the resultant PDF.
<div class="rowdiv" style="margin-top: 10px">
<div class="celldiv" style="font-weight:bold">
Select Document :
@Html.TextBox("file", "", new { type = "file", accept = ".doc,.docx,.rtf,.dot,.dotm,.dotx,docm,.xml" }) <br>
</div>
<div class="rowdiv" style="margin-top: 8px">
<input class="buttonStyle" value="Convert to PDF" name="button" style="width:150px;height:27px" type="submit" tabindex="159">
<br>
<div class="text-danger">
@ViewBag.Message
</div>
</div>
</div>
</div>
</div>
</div>
Html.EndForm();
}}
5. Add the following code to get the Word file and convert it to PDF in the HomeController.cs file.
public async System.Threading.Tasks.Task<ActionResult> Index(string button)
{
if (button == null)
return View();
ViewBag.Message = string.Empty;
if (Request.Form.Files != null)
{
// Gets the extension from file
string extension = Path.GetExtension(Request.Form.Files[0].FileName).ToLower();
// Compares extension with supported extensions
if (extension == ".doc" || extension == ".docx" || extension == ".dot" || extension == ".dotx" || extension == ".dotm" || extension == ".docm"
|| extension == ".xml" || extension == ".rtf")
{
MemoryStream stream = new MemoryStream();
// Retrieves the document stream
Request.Form.Files[0].CopyTo(stream);
try
{
//Creates new instance of WordDocument
WordDocument document = new WordDocument(stream, FormatType.Automatic);
stream.Dispose();
stream = null;
// Creates new instance of DocIORenderer for Word to PDF conversion
DocIORenderer render = new DocIORenderer();
// Converts Word document into PDF document
PdfDocument pdf = render.ConvertToPDF(document);
// Saves the converted PDF file
MemoryStream memoryStream = new MemoryStream();
pdf.Save(memoryStream);
// Releases all resources used by the DocIORenderer and WordDocument instance
render.Dispose();
document.Close();
// Releases all resources used by the PdfDocument instance
pdf.Close();
memoryStream.Position = 0;
return File(memoryStream, "application/pdf", "WordToPDF.pdf");
}
catch (Exception ex)
{
ViewBag.Message = string.Format("The input document could not be processed completely. Please email the document to support@syncfusion.com for troubleshooting.");
}
}
else
{
ViewBag.Message = string.Format("Please choose a Word format document to convert to PDF");
}
}
else
{
ViewBag.Message = string.Format("Browse for a Word document and then click the button to convert it to a PDF document");
}
return View();
}
A runnable .NET Core application capable of Word to PDF conversion can be downloaded here.
Refer to the procedure to deploy your .NET Core application in a Linux OS here.
Users can now convert Word documents to PDF in cross-platform applications (Xamarin and .NET Core) without relying on web services. These applications can run on Windows, Android, Mac, iOS, and Linux.
You can convert an existing Word document or create a Word document from scratch, perform mail merge using the DocIO library, and then convert it to a PDF as required. If you are new to our DocIO library, it is highly recommended to follow our Getting Started guide.
If you’re already a Syncfusion user, you can download the product setup here. If you’re not yet a Syncfusion user, you can download a free, 30-day trial here.
If you have any questions or require clarification about this feature, please let us know in the comments below. You can also contact us through our support forum or Direct-Trac. We are happy to assist you!