Products Technologies Demo Docs Blog Support Company

Updating Your TextControl.Web from X11 to X12

Upgrading Web.TextControl from X11 to X12 requires replacing the TXTextControl.Web assembly reference, updating version strings to 22.0.200.500 in ASPX page registrations and web.config, and adding a new TXPrintHandler entry to enable the direct printing feature introduced in X12.

Updating Your TextControl.Web from X11 to X12

We recently released version X12 with a new version of our HTML5 based editor TextControl.Web. This article shows how to update the references and license information in an existing project.

After you installed version X12, start Visual Studio and open your existing project.

  • In the Solution Explorer, find the TXTextControl.Web reference in the References of your project. Select this old reference and choose Remove from the Edit main menu.

  • Choose Add Reference... from the Project main menu. In the opened dialog box, click Browse... to open the Select the files to reference... dialog.

    Navigate to the installation folder of TX Text Control .NET Server. Default path:

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

    Select TXTextControl.Web and confirm with Add.

    Updating your Web.TextControl from X11 to X12

    Your reference in the Solution Explorer should now look like this:

    Updating your Web.TextControl from X11 to X12
  • Open the Markup of the ASPX page(s) where TXTextControl.Web is used. In the header, the used assembly TXTextControl.Web is registered. Replace the version number with 22.0.200.500. The final tag should look like this:

    <%@ Register assembly="TXTextControl.Web,
        Version=22.0.200.500, Culture=neutral,
        PublicKeyToken=6b83fe9a75cfb638"
        namespace="TXTextControl.Web" tagprefix="cc1" %>

    Repeat this step for all ASPX pages where TXTextControl.Web is used.

  • Find the web.config file in your Solution Explorer and open it. Find the <assemblies> parent element and the <add assembly... element. Replace the version number of TXTextControl.Web to 22.0.200.500.

    Now, Find the <handlers> parent element and the <add name="TXWebSocketHandler"...> element. Please the version number of TXTextControl.Web.WebSocketHandler to 22.0.200.500.

    Add a new entry for the TXPrintHandler, so that the handlers should now look like this:

    <handlers>
      <add name="TXWebSocketHandler"
           verb="*"
           path="TXWebSocketHandler.ashx"
           type="TXTextControl.Web.WebSocketHandler,
              TXTextControl.Web,
              Version=22.0.200.500,
              Culture=neutral, 
              PublicKeyToken=6B83FE9A75CFB638" />
      <add name="TXPrintHandler"
           verb="*"
           path="TXPrintHandler.ashx"
           type="TXTextControl.Web.TXPrintHandler,
              TXTextControl.Web, 
              Version=22.0.200.500,
              Culture=neutral, 
              PublicKeyToken=6B83FE9A75CFB638" />
    </handlers>

Now, your project has been updated to version X12 (22.0). In case, you are using a ServerTextControl and a TXDocumentServer reference as well, replace these references in order to match the following version numbers:

  • TXTextControl: 22.0.1500.500
  • TXTextControl.Server: 22.0.700.500
  • TXDocumentServer: 22.0.800.500

Stay in the loop!

Subscribe to the newsletter to receive the latest updates.

Related Posts

ASP.NETForm FieldsHTML5

X15: Adding MS Word Compatible Fields and Form Elements to TXTextControl.Web

TX Text Control X15 adds JavaScript API support for inserting and modifying MS Word compatible fields in the HTML5-based ASP.NET editor. MergeFields, TextFields, and ApplicationFields can be…


ASP.NETHTML5Release

X15: Inserting Client-Side Images using JavaScript

TX Text Control X15 adds JavaScript ImageCollection methods to insert client-side images into the HTML5-based ASP.NET editor. A local file is read and converted to a Base64 string, then placed…


HTML5MVCRelease

Sneak Peek X15: Copy to Local Clipboard Support in ASP.NET Version

TX Text Control X15 introduces local clipboard support for the HTML5 ASP.NET editor. A toggle switches between the server-side clipboard with full formatting and the client-side HTML clipboard.…


ReportingHTML5MVC

Sneak Peek X15: Custom Field Overlays in HTML5-based Text Control

TX Text Control X15 introduces a bounds property on fields in Web.TextControl, returned through the textFieldEntered event. Developers can position custom HTML overlays at field locations to…


HTML5Mail MergeRelease

ASP.NET: Protected SubTextParts in TXTextControl.Web

SubTextParts in TX Text Control define named text ranges with Start, Length, and Name properties. Version X14 adds subTextPartEntered and subTextPartLeft events to the HTML5-based Web.TextControl,…

Share on this blog post on: