Merge pull request #505 from SyncfusionExamples/1002527-word-to-text

1002527 - How to Convert a Word Document to a Text File Using the .NET Word Library

Author: MathanKumarVaradhaRajaPerumal

Videos/WordToText/Controllers/HomeController.cs

@@ -0,0 +1,112 @@
+using Microsoft.AspNetCore.Mvc;
+using Syncfusion.DocIO;
+using Syncfusion.DocIO.DLS;
+using System.Diagnostics;
+using WordToText.Models;
+
+namespace WordToText.Controllers
+{
+    public class HomeController : Controller
+    {
+        private readonly ILogger<HomeController> _logger;
+
+        public HomeController(ILogger<HomeController> logger)
+        {
+            _logger = logger;
+        }
+
+        public IActionResult WordToText()
+        {
+            // Loads an existing Word document into DocIO instance
+            FileStream fileStreamPath = new FileStream("Data\\Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
+
+            // Load the document into DocIO
+            WordDocument document = new WordDocument(fileStreamPath, FormatType.Docx);
+
+            // Create an output memory stream to hold the document content
+            MemoryStream outputStream = new MemoryStream();
+
+            // Save the new document to the output stream
+            document.Save(outputStream, FormatType.Txt);
+
+            // Close the document 
+            document.Close();
+
+            //Return the output file
+            return File(outputStream, "application/txt", "WordToText.txt");
+        }
+
+        public IActionResult TextToWord()
+        {
+            //Loads an existing Word document into DocIO instance
+            FileStream fileStreamPath = new FileStream("Data\\Template.txt", FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
+
+            // Load the document into DocIO
+            WordDocument document = new WordDocument(fileStreamPath, FormatType.Txt);
+
+            //Create an output memory stream to hold the document content
+            MemoryStream outputStream = new MemoryStream();
+
+            // Save the new document to the output stream
+            document.Save(outputStream, FormatType.Docx);
+
+            //Close the document 
+            document.Close();
+
+            //Return the output file
+            return File(outputStream, "application/docx", "TextToWord.docx");
+        }
+
+        public IActionResult ExtractPlainText()
+        {
+            //Loads an existing Word document into DocIO instance
+            FileStream fileStreamPath = new FileStream("Data\\Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
+
+            // Load the document into DocIO
+            WordDocument document = new WordDocument(fileStreamPath, FormatType.Docx);
+
+            //Get the plain text from the document
+            string text = document.GetText();
+
+            //Create a new Word document to hold the extracted text
+            WordDocument newdocument = new WordDocument();
+
+            //Adds new section
+            IWSection section = newdocument.AddSection();
+
+            //Adds new paragraph
+            IWParagraph paragraph = section.AddParagraph();
+
+            //Append the extracted text to the new document.
+            paragraph.AppendText(text);
+
+            //Create an output stream for the new document
+            MemoryStream outputStream = new MemoryStream();
+
+            //Save the new document to the output stream
+            newdocument.Save(outputStream, FormatType.Docx);
+
+            //Close the document 
+            newdocument.Close();
+
+            //Return the output file
+            return File(outputStream, "application/docx", "ExtractPlainText.docx");
+        }
+
+        public IActionResult Index()
+        {
+            return View();
+        }
+
+        public IActionResult Privacy()
+        {
+            return View();
+        }
+
+        [ResponseCache(Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)]
+        public IActionResult Error()
+        {
+            return View(new ErrorViewModel { RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier });
+        }
+    }
+}

Videos/WordToText/Data/Template.docx

@@ -0,0 +1,15 @@
+Northwind Database
+
+The Northwind sample database (Northwind.mdb) is included with all versions of Access. It provides data you can experiment with and database objects that demonstrate features you might want to implement in your own databases. Using Northwind, you can become familiar with how a relational database is structured and how the database objects work together to help you enter, store, manipulate, and print your data..
+
+It contains the following detailed information:
+1. Suppliers/Vendors of Northwind � who supply to the company.
+2. Customers of Northwind � who buy from Northwind
+3. Employee details of Northwind traders � who work for Northwind
+4. The product information � the products that Northwind trades in
+5. The inventory details � the details of the inventory held by Northwind traders.
+6. The shippers � details of the shippers who ship the products from the traders to the end-customers
+7. PO transactions i.e Purchase Order transactions � details of the transactions taking place between vendors & the company.
+8. Sales Order transaction � details of the transactions taking place between the customers & the company.
+9. Inventory transactions � details of the transactions taking place in the inventory
+10. Invoices � details of the invoice raised against the order.

Videos/WordToText/Data/Template.txt

@@ -0,0 +1,9 @@
+namespace WordToText.Models
+{
+    public class ErrorViewModel
+    {
+        public string? RequestId { get; set; }
+
+        public bool ShowRequestId => !string.IsNullOrEmpty(RequestId);
+    }
+}

Videos/WordToText/Models/ErrorViewModel.cs

@@ -0,0 +1,36 @@
+namespace WordToText
+{
+    public class Program
+    {
+        public static void Main(string[] args)
+        {
+            var builder = WebApplication.CreateBuilder(args);
+
+            // Add services to the container.
+            builder.Services.AddControllersWithViews();
+
+            var app = builder.Build();
+
+            // Configure the HTTP request pipeline.
+            if (!app.Environment.IsDevelopment())
+            {
+                app.UseExceptionHandler("/Home/Error");
+                // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
+                app.UseHsts();
+            }
+
+            app.UseHttpsRedirection();
+            app.UseStaticFiles();
+
+            app.UseRouting();
+
+            app.UseAuthorization();
+
+            app.MapControllerRoute(
+                name: "default",
+                pattern: "{controller=Home}/{action=Index}/{id?}");
+
+            app.Run();
+        }
+    }
+}

Videos/WordToText/Program.cs

@@ -0,0 +1,38 @@
+{
+  "$schema": "http://json.schemastore.org/launchsettings.json",
+  "iisSettings": {
+    "windowsAuthentication": false,
+    "anonymousAuthentication": true,
+    "iisExpress": {
+      "applicationUrl": "http://localhost:3025",
+      "sslPort": 44347
+    }
+  },
+  "profiles": {
+    "http": {
+      "commandName": "Project",
+      "dotnetRunMessages": true,
+      "launchBrowser": true,
+      "applicationUrl": "http://localhost:5214",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    },
+    "https": {
+      "commandName": "Project",
+      "dotnetRunMessages": true,
+      "launchBrowser": true,
+      "applicationUrl": "https://localhost:7040;http://localhost:5214",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    },
+    "IIS Express": {
+      "commandName": "IISExpress",
+      "launchBrowser": true,
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    }
+  }
+}

Videos/WordToText/Properties/launchSettings.json

@@ -0,0 +1,20 @@
+# How to Convert a Word Document to a Text File Using the .NET Word Library
+
+This repository provides an example of how to convert a Word document to a text file using the **Syncfusion .NET Word Library (DocIO)**. It also demonstrates converting a text file back to a Word document and extracting plain text from a Word document. 
+
+## Process behind Field Integration
+
+This sample shows how you can easily switch between Word and text formats using the Syncfusion DocIO library. These conversions are essential for scenarios such as storing content in a lightweight text format for efficient processing or extracting text for indexing and search operations.
+Using the Syncfusion DocIO library, you can:
+
+- Convert a Word document (.docx) to a plain text file (.txt).
+- Convert a text file (.txt) back to a Word document (.docx).
+- Extract plain text from a Word document and save it into a new Word file
+
+## Steps to use the sample
+
+1. Open the ASP.NET Core application where the Syncfusion DocIO package is installed.
+2. Run the application and click the following buttons:
+   - **Word to Text**: Converts a Word document to a plain text file.
+   - **Text to Word**: Converts a text file back to a Word document.
+   - **Extract Plain Text**: Extracts text from a Word document and saves it into a new Word document.

Videos/WordToText/README.md

@@ -0,0 +1,21 @@
+@{
+    ViewData["Title"] = "Home Page";
+}
+
+<div>
+    <h2 style="margin-bottom: 20px"> Text Conversions </h2>
+    <div>
+        <button style="width: 200px; margin-bottom: 20px; height: 40px;display:block;font-size:18px;"
+                onclick="location.href='@Url.Action("WordToText", "Home")'">
+            Word to Text
+        </button>
+        <button style="width: 200px; margin-bottom: 20px; height: 40px;display:block;font-size:18px;"
+                onclick="location.href='@Url.Action("TextToWord", "Home")'">
+            Text to Word
+        </button>
+        <button style="width: 200px; margin-bottom: 20px; height: 40px;display:block;font-size:18px;"
+                onclick="location.href='@Url.Action("ExtractPlainText", "Home")'">
+            Extract Plain Text
+        </button>
+    </div>
+</div>

Videos/WordToText/Views/Home/Index.cshtml

@@ -0,0 +1,6 @@
+@{
+    ViewData["Title"] = "Privacy Policy";
+}
+<h1>@ViewData["Title"]</h1>
+
+<p>Use this page to detail your site's privacy policy.</p>

Videos/WordToText/Views/Home/Privacy.cshtml

@@ -0,0 +1,25 @@
+@model ErrorViewModel
+@{
+    ViewData["Title"] = "Error";
+}
+
+<h1 class="text-danger">Error.</h1>
+<h2 class="text-danger">An error occurred while processing your request.</h2>
+
+@if (Model.ShowRequestId)
+{
+    <p>
+        <strong>Request ID:</strong> <code>@Model.RequestId</code>
+    </p>
+}
+
+<h3>Development Mode</h3>
+<p>
+    Swapping to <strong>Development</strong> environment will display more detailed information about the error that occurred.
+</p>
+<p>
+    <strong>The Development environment shouldn't be enabled for deployed applications.</strong>
+    It can result in displaying sensitive information from exceptions to end users.
+    For local debugging, enable the <strong>Development</strong> environment by setting the <strong>ASPNETCORE_ENVIRONMENT</strong> environment variable to <strong>Development</strong>
+    and restarting the app.
+</p>