Products Technologies Demo Docs Blog Support Company

Getting Started: Document Viewer with ASP.NET Core and Linux WSL Support

In this article, we will create a simple document viewer application using the Document Viewer component from the TX Text Control .NET Server product. We will use ASP.NET Core and run the application on Linux using Windows Subsystem for Linux (WSL).

Getting Started: Document Viewer with ASP.NET Core and Linux WSL Support

Prerequisites

You need to download and install the trial version of TX Text Control .NET Server to host the required backend:

Creating the Application

Make sure that you downloaded the latest version of Visual Studio 2022 that comes with the .NET 8 SDK.

  1. In Visual Studio 2022, create a new project by choosing Create a new project.

  2. Select ASP.NET Core Web App (Model-View-Controller) as the project template and confirm with Next.

  3. Choose a name for your project and confirm with Next.

  4. In the next dialog, choose .NET 8 (Long Term Support) as the Framework and confirm with Create.

    Creating the .NET 8 project

Adding the NuGet Packages

  1. In the Solution Explorer, select your created project and choose Manage NuGet Packages... from the Project main menu. Select Text Control Offline Packages as the Package source.

    Install the following packages:

    • TXTextControl.Web.DocumentViewer
    • TXTextControl.TextControl.Core.SDK

    ASP.NET Core Web Application

Adding the Control to the View

  1. Find the Index.cshtml file in the Views -> Home folder. Replace the complete content with the following code to add the document viewer to the view:

    @using TXTextControl.Web.MVC.DocumentViewer
    @using System.Text
    
    <div style="width: 800px; height: 600px;">
    
    @Html.TXTextControl().DocumentViewer(settings => {
        settings.DocumentData = Convert.ToBase64String(
            Encoding.ASCII.GetBytes("<strong>Sample Content</strong>"));
        settings.Dock = DocumentViewerSettings.DockStyle.Fill;
    }).Render()
    
    </div>
    
    <script>
    
        var jsonAnnotations = '[[{"pen":{"type":"comment","objectWidth":32,"objectHeight":32},"user":"Unknown User","location":{"x":127,"y":50},"time":1658908087097,"comments":[{"comment":"Welcome to Text Control","user":"Unknown User","date":1658908100339,"id":"c8d818ce-ff1e-4c0c-b78c-6ba95a98dede","status":"none"}],"id":"feed80ff-1c94-4abf-9838-3e833faa4092","status":"Accepted"}]]';
    
        window.addEventListener("documentViewerLoaded", function () {
            TXDocumentViewer.annotations.showToolbar(true);
            TXDocumentViewer.annotations.load(jsonAnnotations);
        });
    
    </script>

Starting the Application

  1. Select WSL as the startup profile and start the application.

    Starting the application

Enable WSL (Windows Subsystem for Linux)

In case you haven't enabled WSL yet, follow these steps:

Enable WSL (Windows Subsystem for Linux)

  1. Open PowerShell as an administrator.

  2. Run the following command:

    wsl --install

    This installs the default Linux distribution (usually Ubuntu) and enables necessary features.

  3. After the installation, restart your computer.

Set WSL 2 as the Default Version

To set WSL 2 as the default version, follow these steps:

  1. Open PowerShell as an administrator.

  2. Run the following command:

    wsl --set-default-version 2
  3. If you haven't installed a Linux distribution yet, you can do so via:

    wsl --install -d Ubuntu

Stay in the loop!

Subscribe to the newsletter to receive the latest updates.

Related Posts

ASP.NET CoreDocument EditorLinux

Getting Started: Document Editor with ASP.NET Core and Linux WSL Support

In this article, we will create a simple document editor application using the Document Editor component from the TX Text Control .NET Server product. We will use ASP.NET Core and run the…


ASP.NETASP.NET CoreDocument Viewer

High-Performance Text Replacement in Large DOCX Files using C# .NET

Learn how to efficiently replace text in large DOCX files using C# .NET and the ServerTextControl component from Text Control. This article demonstrates the performance benefits of using the…


ASP.NETASP.NET CoreDocument Viewer

Document Viewer 33.2.1 Released: New Event and Bug Fixes

This service pack includes important bug fixes and improvements to enhance the stability and performance of the Document Viewer. In addition, a new event has been introduced to provide developers…


ASP.NETASP.NET CoreDOCX

Convert MS Word DOCX to PDF including Text Reflow using .NET C# on Linux

This article explains how to use TX Text Control .NET Server to convert a Microsoft Word DOCX document to a PDF file on a Linux system using .NET C#. This conversion process includes text reflow,…


ASP.NETASP.NET CoreDocker

Announcing the Official DS Server Docker Image on Docker Hub

The official DS Server Docker image is now available on Docker Hub. This makes it easier to deploy the DS server in a containerized environment and manage and scale your applications. Based on the…