# Replace Words at the Input Position with Formatted Content from a Web API

> Writing assistance and placeholder replacement are advanced features that help users create professional documents. This sample shows how to replace the word at the current input position with content retrieved from a Web API.

- **Author:** Bjoern Meyer
- **Published:** 2023-07-06
- **Modified:** 2025-11-16
- **Description:** Writing assistance and placeholder replacement are advanced features that help users create professional documents. This sample shows how to replace the word at the current input position with content retrieved from a Web API.
- **2 min read** (303 words)
- **Tags:**
  - ASP.NET
  - ASP.NET Core
  - Electronic Signatures
  - PDF
- **Web URL:** https://www.textcontrol.com/blog/2023/07/06/replace-words-at-the-input-position-with-formatted-content-from-a-web-api/
- **LLMs URL:** https://www.textcontrol.com/blog/2023/07/06/replace-words-at-the-input-position-with-formatted-content-from-a-web-api/llms.txt
- **LLMs-Full URL:** https://www.textcontrol.com/blog/2023/07/06/replace-words-at-the-input-position-with-formatted-content-from-a-web-api/llms-full.txt
- **GitHub Repository:** https://github.com/TextControl/TextControl.Web.Core.MVC.ReplaceWord

---

Writing assistance features significantly speed up the writing process by providing auto-correction, auto-completion, and key phrase replacement, saving time and reducing errors to create a professional document or letter. In particular, pre-designed and phrased sentences that are inserted frequently improve the user experience of such applications.

This sample shows how to replace the word at the current input position with content retrieved from a Web API.

### Web API

To simulate the phrase replacement, the following Web API method *ReplaceWord* accepts a string and returns a value from a dictionary:

```
[HttpGet]
public IActionResult ReplaceWord(string word) {

  Dictionary<string, string> dict = new Dictionary<string, string>()
  {
     { "Word1", "<strong>Formatted</strong> replacement for <em>Word1</em>" },
     { "Word2", "<strong>Formatted</strong> replacement for <em>Word2</em>" },
     { "Word3", "<strong>Formatted</strong> replacement for <em>Word3</em>" }
  };

  return dict.ContainsKey(word) ? Ok(dict[word]) : Ok(null);
}
```

This Web API method is called from JavaScript in the asynchronous method *replaceWord*:

```
function replaceWord(word) {
  return new Promise(resolve => {
    $.get("home/replaceWord", { word: word })
      .done(data => resolve(data))
      .fail(() => resolve(null));
  });
}
```

### Replacing the Selection

When the user presses F8, the word at the input position is selected and retrieved. This word is then sent to the Web API to retrieve the replacement string. This string will eventually be loaded into the selection to replace the current string.

```
TXTextControl.addEventListener("textControlLoaded", async function () {
    document.addEventListener("keydown", logKey);

    async function logKey(e) {
        if (e.key === "F8") {
            const text = await getTextFromSelection();
            const replacedText = await replaceWord(text);

            if (replacedText !== undefined) {
                await loadReplacedText(replacedText);
            }
        }
    }

    function getTextFromSelection() {
        return new Promise(resolve => {
            TXTextControl.selectWord(() => {
                TXTextControl.selection.getText(text => resolve(text));
            });
        });
    }

    async function loadReplacedText(replacedText) {
        const encodedText = btoa(replacedText);
        await TXTextControl.selection.load(TXTextControl.StreamType.HTMLFormat, encodedText);
    }
});
```

The following screen video shows the replacement in action.

![Phrase replacement](https://s1-www.textcontrol.com/assets/dist/blog/2023/07/06/a/assets/replace.gif "Phrase replacement")

You can test this yourself by downloading the Visual Studio project from our GitHub repository.

---

## About Bjoern Meyer

As CEO, Bjoern is the visionary behind our strategic direction and business development, bridging the gap between our customers and engineering teams. His deep passion for coding and web technologies drives the creation of innovative products. If you're at a tech conference, be sure to stop by our booth - you'll most likely meet Bjoern in person. With an advanced graduate degree (Dipl. Inf.) in Computer Science, specializing in AI, from the University of Bremen, Bjoern brings significant expertise to his role. In his spare time, Bjoern enjoys running, paragliding, mountain biking, and playing the piano.

- [LinkedIn](https://www.linkedin.com/in/bjoernmeyer/)
- [X](https://x.com/txbjoern)
- [GitHub](https://github.com/bjoerntx)

---

## Related Posts

- [Preparing Documents for Electronic Signatures using MailMerge in C#](https://www.textcontrol.com/blog/2023/07/05/preparing-documents-for-electronic-signatures-using-mailmerge-in-csharp/llms.txt)
- [Why Structured E-Invoices Still Need Tamper Protection using C# and .NET](https://www.textcontrol.com/blog/2026/03/24/why-structured-e-invoices-still-need-tamper-protection-using-csharp-and-dotnet/llms.txt)
- [Create Fillable PDFs from HTML Forms in C# ASP.NET Core Using a WYSIWYG Template](https://www.textcontrol.com/blog/2026/03/17/create-fillable-pdfs-from-html-forms-in-csharp-aspnet-core-using-a-wysiwyg-template/llms.txt)
- [Why HTML to PDF Conversion is Often the Wrong Choice for Business Documents in C# .NET](https://www.textcontrol.com/blog/2026/03/13/why-html-to-pdf-conversion-is-often-the-wrong-choice-for-business-documents-in-csharp-dot-net/llms.txt)
- [A Complete Guide to Converting Markdown to PDF in .NET C#](https://www.textcontrol.com/blog/2026/01/07/a-complete-guide-to-converting-markdown-to-pdf-in-dotnet-csharp/llms.txt)
- [Why PDF Creation Belongs at the End of the Business Process](https://www.textcontrol.com/blog/2026/01/02/why-pdf-creation-belongs-at-the-end-of-the-business-process/llms.txt)
- [Designing the Perfect PDF Form with TX Text Control in .NET C#](https://www.textcontrol.com/blog/2025/12/16/designing-the-perfect-pdf-form-with-tx-text-control-in-dotnet-csharp/llms.txt)
- [Why Defining MIME Types for PDF/A Attachments Is Essential](https://www.textcontrol.com/blog/2025/12/10/why-defining-mime-types-for-pdfa-attachments-is-essential/llms.txt)
- [Validate Digital Signatures and the Integrity of PDF Documents in C# .NET](https://www.textcontrol.com/blog/2025/11/14/validate-digital-signatures-and-the-integrity-of-pdf-documents-in-csharp-dotnet/llms.txt)
- [Validate PDF/UA Documents and Verify Electronic Signatures in C# .NET](https://www.textcontrol.com/blog/2025/11/13/validate-pdf-ua-documents-and-verify-electronic-signatures-in-csharp-dotnet/llms.txt)
- [How To Choose the Right C# PDF Generation Library: Developer Checklist](https://www.textcontrol.com/blog/2025/11/12/how-to-choose-the-right-csharp-pdf-generation-library-developer-checklist/llms.txt)
- [Why Digitally Signing your PDFs is the Only Reliable Way to Prevent Tampering](https://www.textcontrol.com/blog/2025/10/30/why-digitally-signing-your-pdfs-is-the-only-reliable-way-to-prevent-tampering/llms.txt)
- [Automating PDF/UA Accessibility with AI: Describing DOCX Documents Using TX Text Control and LLMs](https://www.textcontrol.com/blog/2025/10/16/automating-pdf-ua-accessibility-with-ai-describing-docx-documents-using-tx-text-control-and-llms/llms.txt)
- [Converting Office Open XML (DOCX) to PDF in Java](https://www.textcontrol.com/blog/2025/10/14/converting-office-open-xml-docx-to-pdf-in-java/llms.txt)
- [Extending DS Server with Custom Digital Signature APIs](https://www.textcontrol.com/blog/2025/10/09/extending-ds-server-with-custom-digital-signature-apis/llms.txt)
- [Why PDF/UA and PDF/A-3a Matter: Accessibility, Archiving, and Legal Compliance](https://www.textcontrol.com/blog/2025/10/07/why-pdf-ua-and-pdf-a-3a-matter-accessibility-archiving-and-legal-compliance/llms.txt)
- [Convert Markdown to PDF in a Console Application on Linux and Windows](https://www.textcontrol.com/blog/2025/09/23/convert-markdown-to-pdf-in-a-console-application-on-linux-and-windows/llms.txt)
- [Mining PDFs with Regex in C#: Practical Patterns, Tips, and Ideas](https://www.textcontrol.com/blog/2025/08/12/mining-pdfs-with-regex-in-csharp-practical-patterns-tips-and-ideas/llms.txt)
- [Streamline Data Collection with Embedded Forms in C# .NET](https://www.textcontrol.com/blog/2025/08/02/streamline-data-collection-with-embedded-forms-in-csharp-dotnet/llms.txt)
- [Adding QR Codes to PDF Documents in C# .NET](https://www.textcontrol.com/blog/2025/07/15/adding-qr-codes-to-pdf-documents-in-csharp-dotnet/llms.txt)
- [Adding SVG Graphics to PDF Documents in C# .NET](https://www.textcontrol.com/blog/2025/07/08/adding-svg-graphics-to-pdf-documents-in-csharp-dotnet/llms.txt)
- [Enhancing PDF Searchability in Large Repositories by Adding and Reading Keywords Using C# .NET](https://www.textcontrol.com/blog/2025/06/24/enhancing-pdf-searchability-in-large-repositories-by-adding-and-reading-keywords-using-csharp-dotnet/llms.txt)
- [How to Verify PDF Encryption Programmatically in C# .NET](https://www.textcontrol.com/blog/2025/06/20/how-to-verify-pdf-encryption-programmatically-in-csharp-dotnet/llms.txt)
- [PDF Security for C# Developers: Encryption and Permissions in .NET](https://www.textcontrol.com/blog/2025/06/16/pdf-security-for-csharp-developers-encryption-and-permissions-in-dotnet/llms.txt)
- [Add JavaScript to PDFs with TX Text Control in C# .NET: Time-Based Alerts Made Easy](https://www.textcontrol.com/blog/2025/06/13/add-javascript-to-pdfs-with-tx-text-control-in-c-dot-net-time-based-alerts-made-easy/llms.txt)
