Development and Redistribution

Each Text Control product comes with different requirements for development and redistribution. The following articles list the system requirements for development with TX Text Control .NET Server for ASP.NET and which files need to be included for redistribution.

Development System Requirements ASP.NET

Supported Windows versions:

  • Windows Vista
  • Windows Server 2008
  • Windows 7
  • Windows 8
  • Windows Server 2012
  • Windows 8.1
  • Windows 10
  • Windows Server 2016
  • Windows Server 2019

Supported Microsoft .NET Framework Versions:

  • .NET 4.0
  • .NET 4.5
  • .NET 4.6
  • .NET 4.7

Supported Development Environments:

  • Microsoft Visual Studio 2010
  • Microsoft Visual Studio 2012
  • Microsoft Visual Studio 2013
  • Microsoft Visual Studio 2015
  • Microsoft Visual Studio 2017
  • Microsoft Visual Studio 2019
  • Microsoft Internet Information Server 7.0/IIS Express 7.0 or higher

Required Visual C++ runtime:

To use TX Text Control's XML features, the Microsoft XML parser must be installed in the Windows system directory. The following lists the necessary files. Please refer to Microsoft's redistribution policy if you need to redistribute them.

  • MSXML3.DLL (8.00.7820.0)
  • MSXML3A.DLL (8.00.7820.0)
  • MSXML3R.DLL (8.00.7820.0)

Redistribution ASP.NET

All listed files must be deployed in the web application's bin folder and all files must be located at the same level.

\Assembly subdirectory:

  • TXDocumentServer.dll (28.0.1400.500)
  • TXDrawing.dll (27.0.400.500)
  • TXDrawing.Windows.Forms.dll (27.0.400.500)
  • TXTextControl.dll (28.0.2100.500)
  • TXTextControl.Server.dll (28.0.1300.500)
  • TXImageProvider.dll (28.0.200.500)

\Assembly\bin or \Assembly\bin64 subdirectory:

For 32-bit builds, the files from the bin folder are required. For 64-bit builds, the files from the bin64 folder must be deployed. For AnyCPU builds, the set of files depends on the host system's bitness. See TX Text Control 32-bit and 64-bit Edition.

  • tx28_css.dll
  • tx28_doc.dll
  • tx28_dox.dll
  • tx28_htm.dll
  • tx28_pdf.dll
  • tx28_rtf.dll
  • tx28_xlx.dll
  • tx28_xml.dll
  • txic.dll (28.0.1200.500)
  • txkernel.dll (28.0.2800.500)
  • txpdf.dll (28.0.1500.500)
  • txtools.dll (28.0.1100.500)

Example

If an application is deployed to C:\inetpub\wwwroot\My Web Application, all files must be located in the folder C:\inetpub\wwwroot\My Web Application\bin.

Image

Development System Requirements Web Editor

Supported Windows versions:

  • Windows 8
  • Windows Server 2012
  • Windows 8.1
  • Windows 10
  • Windows Server 2016
  • Windows Server 2019

Supported Microsoft .NET Framework Versions:

  • .NET 4.5
  • .NET 4.6
  • .NET 4.7

Supported Development Environments:

  • Microsoft Visual Studio 2012
  • Microsoft Visual Studio 2013
  • Microsoft Visual Studio 2015
  • Microsoft Visual Studio 2017
  • Microsoft Internet Information Server 8.0 or higher
  • IIS Express 8.0 or higher
  • Installed WebSocket protocol

Supported Internet Browsers:

  • Microsoft Internet Explorer 10 or higher
  • Microsoft Edge
  • Mozilla Firefox 31 or higher
  • Google Chrome 36 or higher
  • Apple Safari 5 or higher

Required Visual C++ runtime:

To use TX Text Control's XML features, the Microsoft XML parser must be installed in the Windows system directory. The following lists the necessary files. Please refer to Microsoft's redistribution policy if you need to redistribute them.

  • MSXML3.DLL (8.00.7820.0)
  • MSXML3A.DLL (8.00.7820.0)
  • MSXML3R.DLL (8.00.7820.0)

The deployment of the HTML5 web editor consists of two steps:

1. Deployment of the web application hosting the web editor.

2. Deployment of the TX TextControl Service.

We highly recommend to deploy the TX TextControl Service outside of the web application's bin folder.

1. Deploying the ASP.NET Web Application

The ASP.NET Web application can be deployed just like any other ASP.NET application using the Publish Web functionality of Visual Studio. The following steps are required to publish your created project to your local file system that can be manually copied to your server. Optionally, you can directly publish your Web application to your server, a Windows Azure server or an FTP location. Refer to your Visual Studio documentation to learn how to use the Publish Web feature.

1.1. In your created ASP.NET Web application, select the reference TXTextControl.Web located in the References folder in the Solution Explorer Window. In the Properties Window, set the Copy Local property to true.

Image

1.2. Select Publish %WebApplicationName% from the Build main menu. In the opened dialog Publish Web, select Custom as the publish target. In the opened dialog New Custom Profile, type in a name and confirm with OK.

Image

1.3. In the next page of the dialog, select File System as your Publish method, set the target location and confirm with Next >.

Image

1.4. Confirm the next page with Next > and finally click Publish to start the publishing process.

All of your required files are copied to your specific target location. Copy all of those files to your destination server.

2. Deploying the TX TextControl Service

All necessary files must be copied into the same folder on your server. You will find the distributable files in the following default folder:

C:\Program Files\Text Control GmbH\TX Text Control 28.0.NET Server for ASP.NET\Assembly

and

C:\Program Files\Text Control GmbH\TX Text Control 28.0.NET Server for ASP.NET\Assembly\bin64

The following files from the Assembly folder are required:

  • TXDocumentServer.dll (28.0.1400.500)
  • TXDrawing.dll (27.0.500.500)
  • TXDrawing.Windows.Forms.dll (27.0.400.500)
  • TXTextControl.dll (28.0.2100.500)
  • TXTextControl.Server.dll (28.0.1200.500)
  • TXTextControl.Web.Server.exe (28.0.800.500)
  • TXTextControl.Web.Server.Process.exe (28.0.800.500)
  • TXImageProvider.dll (28.0.200.500)

The following files from the bin64 folder are required:

  • tx28_css.dll
  • tx28_doc.dll
  • tx28_dox.dll
  • tx28_htm.dll
  • tx28_rtf.dll
  • tx28_pdf.dll
  • tx28_xml.dll
  • tx28_xlx.dll
  • txkernel.dll
  • txic.dll
  • txpdf.dll
  • txtools.dll

2.1. Copy the created folder with all of the above files to a preferred location on your destination server. A good place is C:\Program Files\TX TextControl Service XX, where XX equals the version number.

2.2. Copy the command line tool txregwebsvr.exe from the following folder to your destination folder on your server:

C:\Program Files\Text Control GmbH\TX Text Control 28.0.NET Server for ASP.NET\Tools

Example

Image

2.3. On your server, open a Command Prompt explicitly as an administrator and change the directory to the destination folder.

2.4. Type in and execute the following command:

txregwebsvr.exe /i /w

This command will register the TXTextControl.Web.Server.exe as the TX TextControl Service on your server. The optional switches /e and /w will activate interactive services and WebSockets on your server.

To uninstall the TX TextControl Service, please execute the following command:

txregwebsvr.exe /u /d