# Using TX Text Control in ASP.NET Core 3.0 Web Applications

> TX Text Control .NET Server integrates with ASP.NET Core 3.0 through NuGet packages and assembly configurations. The setup requires Visual Studio 2019 Preview, .NET Core 3.0 SDK, and proper middleware registration to enable server-side document processing within Core projects.

- **Author:** Bjoern Meyer
- **Published:** 2019-09-16
- **Modified:** 2026-03-05
- **Description:** TX Text Control .NET Server integrates with ASP.NET Core 3.0 through NuGet packages and assembly configurations. The setup requires Visual Studio 2019 Preview, .NET Core 3.0 SDK, and proper middleware registration to enable server-side document processing within Core projects.
- **4 min read** (711 words)
- **Tags:**
  - ASP.NET
  - .NET Core
  - .NET Core 3.0
  - Visual Studio 2019 Preview
- **Web URL:** https://www.textcontrol.com/blog/2019/09/16/using-tx-text-control-in-asp-net-core-3-web-applications/
- **LLMs URL:** https://www.textcontrol.com/blog/2019/09/16/using-tx-text-control-in-asp-net-core-3-web-applications/llms.txt
- **LLMs-Full URL:** https://www.textcontrol.com/blog/2019/09/16/using-tx-text-control-in-asp-net-core-3-web-applications/llms-full.txt

---

.NET Core 3.0 will be launched at [.NET Conf](https://www.dotnetconf.net/), September 23-25th and the current version *Preview 9* is the last preview before the final release. We tested our latest versions against this new framework and this article explains how to use TX Text Control .NET Server in an ASP.NET Core 3 Web Application.

In order to create a .NET Core 3 application, you will need to download the .NET Core 3.0 SDK:

[Download .NET Core 3.0](https://dotnet.microsoft.com/download/dotnet-core/3.0)

Visual Studio 2019 doesn't provide .NET Core 3.0 as a selectable target. Visual Studio 2019 Preview is required to create .NET Core 3.0 applications:

[Visual Studio 2019 Preview Release Notes](https://docs.microsoft.com/en-us/visualstudio/releases/2019/release-notes-preview#16.3.0-pre.3.0)

### Why Is .NET 3.0 Supported and Not .NET 2.1?

Word processing is a complex task and requires some high-performance modules which are written in C++. Finally, the .NET Core 3.0 runtime added support for IJW C++/CLI on Windows that makes .NET Core 3.0 a usable target for TX Text Control applications running on Windows.

Additionally, the official package [System.Drawing.Common](https://www.nuget.org/packages/System.Drawing.Common) from Microsoft provides access to GDI+ graphics functionality which is required in TX Text Control applications.

### Creating the Application

The following tutorial shows how to create an ASP.NET Core 3 Web Application that can be deployed to Windows machines.

1. In Visual Studio 2019 Preview, create a new project and select *ASP.NET Core Web Application* as the project template.
    
    ![Create a .NET Core 3 application](https://s1-www.textcontrol.com/assets/dist/blog/2019/09/16/a/assets/vs2019_step1.webp "Create a .NET Core 3 application")
2. Select a project name, location and solution name in the next dialog and confirm with *Create*.
3. In the last dialog, select *.NET Core* and *ASP.NET Core 3.0* as the project target, select *Web Application (Model-View-Controller)* as the template and confirm with *Create*.
    
    ![Create a .NET Core 3 application](https://s1-www.textcontrol.com/assets/dist/blog/2019/09/16/a/assets/vs2019_step2.webp "Create a .NET Core 3 application")
4. Open the *Package Manager Console* by choosing *Package Manager Console* from the *Tools -> NuGet Package Manager* main menu and type in the following command to install the *System.Drawing.Common* package:
    
    ```
    PM> Install-Package System.Drawing.Common
    ```
5. While the project is selected in the *Solution Explorer*, choose *Project -> Add Reference...* to open the *Reference Manager*. In the opened dialog, select *Browse...* to select the required TX Text Control assemblies. Navigate to the installation folder of TX Text Control and select the following assemblies from the *Assembly* folder:
    
    
    - TXDocumentServer.dll
    - TXTextControl.dll
    - TXTextControl.Server.dll
    
    ![Create a .NET Core 3 application](https://s1-www.textcontrol.com/assets/dist/blog/2019/09/16/a/assets/vs2019_step3.webp "Create a .NET Core 3 application")
    
    Repeat this step with the following assemblies from the *Assembly/bin64* folder:
    
    
    - txic.dll
    - txkernel.dll
    - txtools.dll
    
    After selecting these assemblies, close the *Reference Manager* by confirming with *OK*.
6. While the project is selected in the *Solution Explorer*, choose *Project -> Add Existing Item...*. Browse to the TX Text Control installation folder and select the following files from the *Assembly/bin64*:
    
    
    - tx27\_xml.dll
    - tx27\_css.dll
    - tx27\_doc.dll
    - tx27\_dox.dll
    - tx27\_htm.dll
    - tx27\_pdf.dll
    - tx27\_rtf.dll
    - tx27\_xlx.dll
7. Select the files from step 6 in the *Solution Explorer* and set the *Copy to Output Directory* to *Copy always*.
8. While the project is selected in the *Solution Explorer*, choose *Project -> Add New Item...*. Select *Text File*, name the file *licenses.licx* and close the dialog by clicking *Add*.
    
    ![Create a .NET Core 3 application](https://s1-www.textcontrol.com/assets/dist/blog/2019/09/16/a/assets/vs2019_step4.webp "Create a .NET Core 3 application")
    
    Open the newly added file and add the following content:
    
    ```
    TXTextControl.ServerTextControl, TXTextControl.Server, Culture=neutral, PublicKeyToken=6b83fe9a75cfb638
    ```
    
    Set the *Build Action* property to *Embedded Resource*.

In case, you are getting compile errors (*MSB6003 The specified task executable "lc.exe" could not be run.*), please refer to this article:

[LC Task in .NET Core Projects](https://www.textcontrol.com/blog/2020/04/29/lc-task-in-dotnet-core-projects/llms-full.txt)

Now, you can use *ServerTextControl* and *MailMerge* in your .NET Core 3 Web Application:

```
public IActionResult Index()
{
    using (TXTextControl.ServerTextControl tx = new TXTextControl.ServerTextControl())
    {
        tx.Create();
        // ...
    }

    return View();
}
```

---

## 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

- [ASP.NET Core: Deploying the TX Text Control 32.0 SP2 Document Editor to Linux](https://www.textcontrol.com/blog/2024/01/22/deploying-tx-text-control-to-linux/llms.txt)
- [ASP.NET Core: Deploying the TX Text Control Document Viewer to Azure App Services](https://www.textcontrol.com/blog/2022/11/29/deploying-document-viewer-to-linux/llms.txt)
- [Visual Studio 2022 and .NET 5, 6 and 7 (Preview) Support and Strategy](https://www.textcontrol.com/blog/2022/08/11/visual-studio-2022-net-5-6-7-support-and-strategy/llms.txt)
- [2021 Wrap Up - Rethinking Documents](https://www.textcontrol.com/blog/2021/12/22/2021-wrap-up-rethinking-documents/llms.txt)
- [ASP.NET Core: Deploying the TX Text Control Document Viewer to Azure App Services](https://www.textcontrol.com/blog/2021/11/08/deploying-document-viewer-to-linux/llms.txt)
- [ASP.NET Core: Deploying the TX Text Control Document Editor to Linux](https://www.textcontrol.com/blog/2021/10/29/deploying-tx-text-control-to-linux/llms.txt)
- [Announcing TX Text Control Support for .NET 5](https://www.textcontrol.com/blog/2021/05/04/announcing-tx-text-control-support-for-dotnet-5/llms.txt)
- [Angular DocumentViewer: Loading Documents from an ASP.NET Core Backend Web API](https://www.textcontrol.com/blog/2020/06/08/angular-documentviewer-loading-documents-from-backend/llms.txt)
- [Building an Angular Application with an ASP.NET Core Back-End](https://www.textcontrol.com/blog/2020/05/06/building-an-angular-application-with-an-aspnet-core-backend/llms.txt)
- [LC Task in .NET Core Projects](https://www.textcontrol.com/blog/2020/04/29/lc-task-in-dotnet-core-projects/llms.txt)
- [ASP.NET Core: Server-Side MailMerge](https://www.textcontrol.com/blog/2020/04/28/aspnet-core-server-side-mailmerge/llms.txt)
- [Creating an ASP.NET Core Web Application using TXTextControl.Web](https://www.textcontrol.com/blog/2020/04/24/creating-an-aspnet-core-web-application-using-txtextcontrolweb/llms.txt)
- [TXTextControl.Web for ASP.NET Core Web Applications Released](https://www.textcontrol.com/blog/2020/04/24/textcontrol-for-aspnet-core-web-released/llms.txt)
- [DocumentViewer for .NET Core 3.1 Released](https://www.textcontrol.com/blog/2020/04/08/documentviewer-for-dotnet-core-released/llms.txt)
- [ReportingCloud .NET Core Quickstart Tutorial](https://www.textcontrol.com/blog/2019/07/24/reportingcloud-dotnet-core-quickstart-tutorial/llms.txt)