Azure App Service is used to build and host web applications without managing the infrastructure. Azure is taking over the task of auto-scaling and high availability.

There are two options to deploy applications to Azure App Service:

  • Code
    This option is used to simply deploy an application to Azure App Service. The application runs in a ready-to-use virtual environment where several settings such as the supported .NET Framework or platform bitness can be adjusted.

  • Container
    Web App for Containers gives developers more control over what is installed in their containers.

The App Service Sandbox

The major problem with the first Code approach is the Azure Web App Sandbox. The limitations of the sandbox include access to write to the registry, access to event logs and it prevents access to most User32 and GDI32 system calls. TX Text Control leverages these calls to provide the true WYSIWYG rendering, just like most other libraries that create PDF documents for instance.

When using Web App for Containers, these calls will succeed and TX Text Control can be used in Azure App Service applications. Also, Microsoft is offering cached base Windows images for faster initialization. Therefore, a typical initial deployment of Windows Server 2019 Core takes only several minutes.

Quickstart: Deploying TX Text Control

This quickstart tutorial shows how to deploy an ASP.NET web application in a Windows image to Docker Hub from Visual Studio 2019. The application uses the ServerTextControl TX Text Control .NET Server for ASP.NET
TXTextControl Namespace
ServerTextControl Class
The ServerTextControl class implements a component that provide high-level text processing features for server-based applications.
and MailMerge TX Text Control .NET Server for ASP.NET
DocumentServer Namespace
MailMerge Class
The MailMerge class is a .NET component that can be used to effortlessly merge template documents with database content in .NET projects, such as ASP.NET web applications, web services or Windows services.
classes to create a document and to show that document in the ASP.NET MVC DocumentViewer TX Text Control .NET Server for ASP.NET
Web.MVC.DocumentViewer Namespace
DocumentViewer Class
The DocumentViewer class represents an extension object implementing the TX Text Control DocumentViewer functionality.
. Finally, you will learn how to run the application in a container in Azure App Service.


In order to complete this tutorial, the following prerequisites are required:

Creating the ASP.NET Web Application

The following steps are required to create a new ASP.NET Web Application.

  1. Open Visual Studio 2019 and select Create a new project.
  2. In the dialog Create a new project, select ASP.NET Web Application (.NET Framework) for C# and confirm with Next.

    Visual Studio 2019

  3. In Configure a new project, enter the name myTextControlAzureApp and confirm with Create.

    Visual Studio 2019

  4. Select MVC as the project template, select Docker support and make sure that No Authentication is selected for the Authentication type. To finish the creation, click Create.

    Visual Studio 2019

  5. After the project has been created, find the Dockerfile file in the Solution Explorer and open it. Change the parent image to a supported parent image (> Server Core 2016). Also, the C++ 2013 Redistributables are required and will be automatically deployed to the container. Replace the content with the following commands, so that the complete Dockerfile looks like this:


Adding TX Text Control

In this tutorial step, the sample invoice template and the shipped XML data source is used to create a document that is displayed in the DocumentViewer.

  1. Select Add Reference... from the Project main menu. In the opened dialog box, click Browse... and navigate to the TX Text Control installation folder. Select the files TXDocumentServer.dll, TXDrawing.dll, TXDrawing.Windows.Forms.dll, TXImageProvider.dll, TXTextControl.dll and TXTextControl.Server.dll and click Add to add these references. Click OK to close the Reference Manager.

    Visual Studio 2019

  2. In the Solution Explorer, right-click the folder Properties and select Add > Text File, name it licenses.licx and click OK. Add the following content to the file:

  3. In the Solution Explorer, select the project myTextControlAzureApp and select Add Existing Item... form the Project main menu. Navigate to the TX Text Control installation folder and find the Assembly > bin64 folder. Select all files and click Add.

    Visual Studio 2019

  4. In the Solution Explorer, select the added files and set the properties Build Action to Content and Copy to Output Directory to Copy Always.

  5. In the Solution Explorer, select the App_Data folder and select Add Existing Item... from the Project main menu. Find the TX Text Control installation folder, open Samples > Demo and add the files invoice.docx and sample_db.xml. Click Add to include the files. Set the properties Build Action to Content and Copy to Output Directory to Copy Always.

    Visual Studio 2019

  6. Click Manage NuGet Packages... from the Project main menu. Select from the Online package source panel. In the upper right corner, search for TXTextControl.Web.DocumentViewer. Find the latest version and click on Install.

Creating the Demo Code

  1. In the Solution Explorer, select the Models folder and create a new class file by choosing Add Class... from the Project main menu. Name the new class DocumentView.cs and add the following code:

  2. Open the HomeController from the Controllers folder and replace the code with the following controller code:

  3. Open the view file Views > Home > Index.cshtml and replace the content with the following content:


Installing Required Fonts

Windows Server Core 2019 does not come with pre-installed fonts which is an essential part for document processing applications. Instead of deploying fonts to the server, fonts can be locally registered for individual applications.

  1. Create 2 new folders in the project named InstallFonts and Helpers.

  2. In the folder Helpers, create a new class file Fonts.cs and copy the following code into it:

  3. Copy required fonts from your local font folder (C:\Windows\Fonts) to the InstallFonts folder. For testing, copy only a handful of fonts to safe space. Set the properties Build Action to Content and Copy to Output Directory to Copy Always

  4. Find the file Global.asax in the project's root folder and replace it with this code:

  5. From the Visual Studio menu, select Debug > Start Without Debugging to run the web application locally.

    TX Text Control DocumentViewer

Publish to Docker Hub

  1. In the Solution Explorer, right-click myTextControlAzureApp and select Publish.

  2. Select Container Registry as the target and Docker Hub as the registry. Click Create Profile to confirm.

    Docker Hub

  3. In the opened Docker Hub dialog box, enter your Docker Hub credentials and confirm with Save.

  4. In the opened Publish page, click on Publish to publish your project to the Docker Hub.

    Docker Hub

Creating an Azure Windows Container App

Now, the created Docker container can be deployed as an Azure Windows Container App to Azure App Service.

  1. Open the Azure Portal and sign in with your Azure account.

  2. Find App Services in the left-hand menu and open it. Select + Add from the menu to create a new service.

    App Service

  3. In the opened page, choose your Azure subscription and a Resource Group.

  4. Choose a Name for your application, select Docker Container and Windows as the Operating System. Select a region for your deployment and click Next: Docker.

    App Service

  5. In the next page Docker, select Docker Hub as the Image Source, Public as the Access Type and enter your Image name and tag of the create container image (in this case: textcontrol/mytextcontrolazureapp:latest).

    App Service

  6. Select Review and Create and click Create.

Browse the Container App

After Azure created the application, a notification box is displayed. You will also find the deployed application in the list of App Services.

  1. Select the newly created App Service. Find the URL in the overview page and click on the link to open it in a new browser tab.

    App Service