The TX Text Control document editor for Angular can be used in ASP.NET Core Web Applications. The back-end Web API of the ASP.NET Core Web Application can be used to load data and to merge templates created using the online editor.
This article shows how to create a new ASP.NET Core back-end Web Application with an Angular front-end SPA.
Creating the Application
The following tutorial shows how to create an ASP.NET Core 3 Web Application that can be deployed to Windows machines.
In Visual Studio 2019 (> 16.5.4), create a new project, select ASP.NET Core Web Application as the project template and continue with Next.
Select a project name, location and solution name in the next dialog and confirm with Create.
In the last dialog, select .NET Core and ASP.NET Core 3.1 as the project target, select Angular as the template and confirm with Create.
Adding TX Text Control Assemblies
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:
Repeat this step with the following assemblies from the Assembly/bin64 folder:
After selecting these assemblies, close the Reference Manager by confirming with OK.
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:
Select the files from step 5 in the Solution Explorer and set the Copy to Output Directory to Copy always.
Adding the License
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.
Open the newly added file and add the following content:
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:
In the Solution Explorer, select your created project and choose Manage NuGet Packages... from the Project main menu.
Browse for txtextcontrol.web and Install the latest version of the TXTextControl.Web package.
Adding the Middleware
Open the Startup.cs file located in the project's root folder. In the Configure method, add the following code to the end of the method:
Adding TX Text Control Angular
Select Command Line -> Developer Command Prompt from the Tools main menu. A command line is opened in the application's root folder. Switch to the ClientApp folder by typing the following command:cd dotnetcoreangular\ClientApp
Install the TX Text Control document editor package by typing in the following command:ng add @txtextcontrol/tx-ng-document-editor
Close the command line prompt after the packages are installed.
In Visual Studio, find the file ClientApp -> src -> app -> home -> home.component.html and replace the complete content with the following:
Replace the port number (32760) with the port number of your application. To find that port number, start the application and check the browser location bar.
Start the application by pressing F5. If you see an error, make sure that you replaced the port number in step 13.
Implementing a Web API
Using the above tutorial, you created an ASP.NET Core Web Application that provides the WebSocketHandler middleware connected to the Angular document editor. The following sample, that can be downloaded from GitHub, implements a backend Web API to merge templates created in the editor with data.
The ASP.NET Core Web Application implements two simple endpoints to merge templates with dummy data and an endpoint to return dummy excerpt data:
In the constructor of the home component (home.component.ts), the LoadData endpoint is called to get dummy data:
On starting the application, the Insert Merge Field drop-down is filled with the data loaded from the endpoint:
The view contains a button that calls the onClickMergeDocument event:
In the TypeScript function onClickMergeDocument, the document is saved, posted to the endpoint MergeDocument and the result is loaded back into TX Text Control.
Download the sample and try this on your own.