The TX Text Control Document Viewer can be used in a Blazor Web App in server-side rendering mode. .NET 8 allows you to control the rendering mode by component. The whole concept and how to create a new Blazor Web App using the TX Text Control Document Viewer can be found in the article below.

Learn More

This article shows how to use the Document Viewer in a Blazor Server application with .NET 8. The Document Viewer is a powerful, web-based document viewer that can be easily integrated into any Blazor application.

Using the Document Viewer in a Blazor Server App with .NET 8

SignatureSettings Object

This example is based on such a tutorial project, but it implements the workflow of an electronic signature acquisition process. The example uses the same structure to load documents, but this time with SignatureSettings to enable the signature mode.

The following implementation of LoadDocumentFromFile uses a SignatureSettings object to set the signature settings for the document being signed.

public void LoadDocumentFromFile(string filename)
// check if the file exists
if (!System.IO.File.Exists(filename))
// load the file into a byte array
byte[] bDocument = System.IO.File.ReadAllBytes(filename);
SignatureSettings signatureSettings = new SignatureSettings()
OwnerName = "John Doe",
RedirectUrlAfterSignature = this.BasePath + "Signature/SignDocument",
UniqueId = Guid.NewGuid().ToString(),
SignerName = "Jane Doe",
SignatureBoxes = new SignatureBox[]
new SignatureBox("txsign")
Style = SignatureBox.SignatureBoxStyle.Signature
ShowSignatureBar = true
// invoke the JS function 'loadDocument' to load back to the modified document
_txdocumentviewer?.InvokeVoidAsync("loadDocument", new object[] { Convert.ToBase64String(bDocument), filename, BasePath, signatureSettings });
view raw test.razor hosted with ❤ by GitHub

The RedirectUrlAfterSignature property is set to a controller that is part of the implementation of the Razor Web App. A sample document with a signature field is loaded after clicking the Load Document button.

TX Text Control in Blazor

Controller Web API

After signing and submitting, the document is signed and forwarded to the specified controller method.

TX Text Control in Blazor

The controller method loads the signed document, which is returned in the internal TX Text Control format, signs the signature fields by applying a digital certificate, and exports the document as a PDF.

public class SignatureController : Controller
public ActionResult SignDocument([FromBody] SignatureData signatureData)
byte[] bPDF;
// create temporary ServerTextControl
using (TXTextControl.ServerTextControl tx = new TXTextControl.ServerTextControl())
// load the document
// create a certificate
X509Certificate2 cert = new X509Certificate2("App_Data/textcontrolself.pfx", "123");
// assign the certificate to the signature fields
TXTextControl.SaveSettings saveSettings = new TXTextControl.SaveSettings()
CreatorApplication = "TX Text Control Blazor Sample Application",
SignatureFields = new DigitalSignature[] {
new TXTextControl.DigitalSignature(cert, null, "txsign")
// save the document as PDF
tx.Save("App_Data/results_" + signatureData.UniqueId + ".pdf", TXTextControl.StreamType.AdobePDF, saveSettings);
return Ok();
view raw test.cs hosted with ❤ by GitHub

PDF Creation

The PDF document is then stored on the server in the App_Data folder.

TX Text Control in Blazor

Visit our GitHub repository to download and review the full application.