# Using TX Text Control in Windows Azure > Deploying TX Text Control Server for ASP.NET on Windows Azure requires creating a Visual Studio Azure project, adding TXTextControl.dll and TXTextControl.Server.dll with Copy Local set to True, bundling bin64 files, configuring licenses.licx, and publishing the package to Azure. - **Author:** Bjoern Meyer - **Published:** 2012-04-24 - **Modified:** 2026-07-17 - **Description:** Deploying TX Text Control Server for ASP.NET on Windows Azure requires creating a Visual Studio Azure project, adding TXTextControl.dll and TXTextControl.Server.dll with Copy Local set to True, bundling bin64 files, configuring licenses.licx, and publishing the package to Azure. - **6 min read** (1042 words) - **Tags:** - Sample - Tutorial - **Web URL:** https://www.textcontrol.com/blog/2012/04/24/using-tx-text-control-in-windows-azure/ - **LLMs URL:** https://www.textcontrol.com/blog/2012/04/24/using-tx-text-control-in-windows-azure/llms.txt - **LLMs-Full URL:** https://www.textcontrol.com/blog/2012/04/24/using-tx-text-control-in-windows-azure/llms-full.txt --- ![Windows Azure Logo](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/logo_azure_large.webp "Windows Azure Logo")While creating a sample application that shows the stunning improvements of our **Adobe PDF import functionality**, I thought to revisit how TX Text Control Server for ASP.NET can be used in a Windows Azure environment. Windows Azure is the perfect environment to host, scale, and manage web applications. TX Text Control Server for ASP.NET is **Azure Ready** and can be easily used in Microsoft datacenters. Tutorial: Azure Hosted Service with TX Text Control --------------------------------------------------- 1. Ensure that the **Windows Azure Tools for Visual Studio** are installed, start Visual Studio 2010 and create a new project. The **Windows Azure Tools for Visual Studio** can be downloaded on this dedicated website: ![Text Control](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/sdk.webp "Text Control") [Get Started with Windows Azure](http://www.microsoft.com/windowsazure/getstarted/) From the installed project templates, choose *Windows Azure Project* from the *Cloud* category. [![TX Text Control in Windows Azure](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/step1_zoom.webp "TX Text Control in Windows Azure")](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/step1_zoom.webp) In the next dialog box, choose an appropriate role for this new project. For this tutorial, we will select *ASP.NET Web Role*. Add this role to the solution and confirm with *OK*. [![TX Text Control in Windows Azure](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/step2_zoom.webp "TX Text Control in Windows Azure")](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/step2_zoom.webp) 2. Select the web application (*WebRole1*) in the *Solution Explorer* and select *Add Reference...* from the *Project* main menu. Browse for the *TXTextControl.dll* and the *TXTextControl.Server.dll* from the *Assembly* folder of the TX Text Control installation directory. [![TX Text Control in Windows Azure](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/step3_zoom.webp "TX Text Control in Windows Azure")](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/step3_zoom.webp) Select the added references in the *Solution Explorer* and set their *Copy Local* property to *True*. [![TX Text Control in Windows Azure](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/step4_zoom.webp "TX Text Control in Windows Azure")](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/step4_zoom.webp) 3. Select the web application (*WebRole1*) in the *Solution Explorer* again and choose *Add Existing Item...* from the *Project* main menu. Browse for the TX Text Control installation folder (default: *C:\\Program Files\\Text Control GmbH\\TX Text Control 17.0.NET for Windows Forms\\Assembly\\bin64*), select all files from the bin64 folder and confirm with *Add*. [![TX Text Control in Windows Azure](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/step5_zoom.webp "TX Text Control in Windows Azure")](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/step5_zoom.webp) Now, select all newly added files in the *Solution Explorer* and set their properties *Build Action* to *Content* and *Copy to Output Directory* to *Copy always*. 4. A 'licenses.licx' file must exist in the 'Properties' folder (C#) or the 'My Project' folder (VB.NET). To build such a file, create a new text file in this folder and name it 'licenses.licx'. Open the file and add the following string: ``` TXTextControl.ServerTextControl, TXTextControl.Server, Version=17.0.200.500, Culture=neutral, PublicKeyToken=6b83fe9a75cfb638 ``` 5. Open the *Split* view of the *Default.aspx* page and remove the default content between the *MainContent* placeholder tags. Add a simple button to the page and double-click it to open the code-behind automatically. Add the following code to the button click event: ``` using (TXTextControl.ServerTextControl tx = new TXTextControl.ServerTextControl()) { byte[] data = null; tx.Create(); tx.Text = "This is a sample text."; tx.Save(out data, TXTextControl.BinaryStreamType.AdobePDF); Response.Clear(); Response.ContentType = "application/pdf"; Response.BinaryWrite(data); Response.End(); } ``` 6. Select the *Windows Azure Project* in the *Solution Explorer* and select *Publish \[tx\_in\_the\_cloud\]* from the *Build* main menu. [![TX Text Control in Windows Azure](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/step6_zoom.webp "TX Text Control in Windows Azure")](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/step6_zoom.webp) In the opened dialog box, select *Create Service Package Only* and confirm with *OK*. [![TX Text Control in Windows Azure](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/step7_zoom.webp "TX Text Control in Windows Azure")](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/step7_zoom.webp) Visual Studio is opening a folder with two created files. 7. Open the ***Windows Azure Management Portal***: If you did not create an account for Windows Azure yet, follow the required steps on their website. 8. Choose *New Hosted Service* from the *Common Tasks*. Complete the form fields in the opened dialog box describing the name and URL of the newly created application. Browse for the *Package location* and the *Configuration file* by clicking the *Browse Locally...* buttons. Choose the files that have been created by Visual Studio. Upload the project by clicking *OK*. [![TX Text Control in Windows Azure](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/step8_zoom.webp "TX Text Control in Windows Azure")](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/step8_zoom.webp) The uploading and finalizing by Windows Azure might take some time. Depending on the size of the project up to 30 minutes or more. [![TX Text Control in Windows Azure](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/step9_zoom.webp "TX Text Control in Windows Azure")](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/step9_zoom.webp) 9. If the upload process is successful, the hosted service is displayed in the list as shown in the following screenshot: [![TX Text Control in Windows Azure](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/step10_zoom.webp "TX Text Control in Windows Azure")](https://s1-www.textcontrol.com/assets/dist/blog/2012/04/24/a/assets/step10_zoom.webp) Now, the application is available "in the cloud" using the given URL (e.g. *http://txcloudtest.cloudapp.net/*). --- ## About Bjoern Meyer As CEO, Bjoern is the visionary behind our strategic direction and business development, bridging the gap between our customers and engineering teams. His deep passion for coding and web technologies drives the creation of innovative products. If you're at a tech conference, be sure to stop by our booth - you'll most likely meet Bjoern in person. With an advanced graduate degree (Dipl. Inf.) in Computer Science, specializing in AI, from the University of Bremen, Bjoern brings significant expertise to his role. In his spare time, Bjoern enjoys running, paragliding, mountain biking, and playing the piano. - [LinkedIn](https://www.linkedin.com/in/bjoernmeyer/) - [X](https://x.com/txbjoern) - [GitHub](https://github.com/bjoerntx) --- ## Related Posts - [Porting RapidSpell to TX Spell .NET](https://www.textcontrol.com/blog/2011/12/22/porting-rapidspell-to-tx-spell-net/llms.txt) - [Windows Forms Tutorial: Create Your First Windows Forms C# Application](https://www.textcontrol.com/blog/2024/08/26/windows-forms-tutorial-create-your-first-windows-forms-csharp-application/llms.txt) - [How to Mail Merge MS Word DOCX Documents in ASP.NET Core C#](https://www.textcontrol.com/blog/2023/10/16/how-to-mail-merge-ms-word-docx-documents-in-aspnet-core-csharp/llms.txt) - [Creating an Angular Document Editor Application with a Node.js WebSocket Server](https://www.textcontrol.com/blog/2023/08/24/creating-an-angular-document-editor-application-with-a-nodejs-websocket-server/llms.txt) - [Create a Table of Contents in Windows Forms using C#](https://www.textcontrol.com/blog/2023/01/23/create-toc-in-windows-forms/llms.txt) - [Official TX Text Control .NET Sample Applications Are Now Hosted on GitHub](https://www.textcontrol.com/blog/2023/01/08/official-tx-text-control-net-sample-applications-are-now-hosted-on-github/llms.txt) - [Adding SVG Watermarks to Documents](https://www.textcontrol.com/blog/2022/01/28/adding-svg-watermarks-to-documents/llms.txt) - [Using MailMerge in ASP.NET Core 6 Web Applications](https://www.textcontrol.com/blog/2022/01/27/using-mailmerge-in-aspnet-core-6-web-applications/llms.txt) - [Detect Toggle Button Changes Using a MutationObserver](https://www.textcontrol.com/blog/2021/11/11/detect-toggle-button-changes-using-a-mutationobserver/llms.txt) - [Two Ways to Restart Numbered Lists in TX Text Control](https://www.textcontrol.com/blog/2021/11/03/two-ways-to-restart-numbered-lists/llms.txt) - [Zoom Tricks: Disabling CTRL + MOUSE WHEEL and More](https://www.textcontrol.com/blog/2020/12/09/zoom-tricks-disabling-ctrl-mouse-wheel-and-more/llms.txt) - [DocumentViewer for React Prerelease](https://www.textcontrol.com/blog/2020/10/27/document-viewer-for-react-prerelease/llms.txt) - [New DocumentViewer Signature Tutorial Sample](https://www.textcontrol.com/blog/2020/08/18/new-documentviewer-signature-tutorial-sample/llms.txt) - [Creating an ASP.NET MVC DocumentViewer Application With Razor](https://www.textcontrol.com/blog/2020/01/01/creating-an-aspnet-mvc-documentviewer-application-with-razor/llms.txt) - [Creating Your First Windows Forms Application with C#](https://www.textcontrol.com/blog/2020/01/01/creating-your-first-windows-forms-application-with-csharp/llms.txt) - [Creating Your First WPF Application](https://www.textcontrol.com/blog/2020/01/01/creating-your-first-wpf-application/llms.txt) - [Creating a WPF Ribbon Application](https://www.textcontrol.com/blog/2020/01/01/creating-a-wpf-ribbon-application/llms.txt) - [Integrate Document Editing into any HTML Client using the HTML Widget](https://www.textcontrol.com/blog/2020/01/01/integrate-document-editing/llms.txt) - [Creating an ASP.NET MVC Application With Razor](https://www.textcontrol.com/blog/2020/01/01/creating-an-aspnet-mvc-application-with-razor/llms.txt) - [Creating A Windows Forms Ribbon Application](https://www.textcontrol.com/blog/2020/01/01/creating-a-windows-forms-ribbon-application/llms.txt) - [Creating Your First ASP.NET Reporting Application](https://www.textcontrol.com/blog/2020/01/01/creating-your-first-aspnet-reporting-application/llms.txt) - [Creating an ASP.NET Web Forms AJAX Application](https://www.textcontrol.com/blog/2020/01/01/creating-an-aspnet-web-forms-ajax-application/llms.txt) - [Creating a WebSocket Server Project with Node.js](https://www.textcontrol.com/blog/2020/01/01/creating-a-websocket-server-project-with-nodejs/llms.txt) - [Creating an Angular Document Editor Application](https://www.textcontrol.com/blog/2020/01/01/creating-an-angular-document-editor-application/llms.txt) - [ReportingCloud .NET Core Quickstart Tutorial](https://www.textcontrol.com/blog/2019/07/24/reportingcloud-dotnet-core-quickstart-tutorial/llms.txt)