991257 - How to Work with Fields in Word Documents Using the .NET Word Library

Videos/Fields/Controllers/HomeController.cs

@@ -0,0 +1,104 @@
+using System.Diagnostics;
+using Fields.Models;
+using Microsoft.AspNetCore.Mvc;
+using Syncfusion.DocIO;
+using Syncfusion.DocIO.DLS;
+
+namespace Fields.Controllers
+{
+    public class HomeController : Controller
+    {
+        private readonly ILogger<HomeController> _logger;
+
+        public HomeController(ILogger<HomeController> logger)
+        {
+            _logger = logger;
+        }
+
+        public IActionResult AddField()
+        {
+            using (FileStream fileStream = new FileStream("Data\\Template.docx", FileMode.Open, FileAccess.Read))
+            {
+                WordDocument document = new WordDocument(fileStream, FormatType.Automatic);
+
+                foreach (WSection section in document.Sections)
+                {
+                    WParagraph footerParagraph = (WParagraph)section.HeadersFooters.Footer.AddParagraph();
+
+                    footerParagraph.ParagraphFormat.HorizontalAlignment = HorizontalAlignment.Center;
+
+                    footerParagraph.AppendText("Page ");
+                    footerParagraph.AppendField("Page", FieldType.FieldPage);
+
+                    footerParagraph.AppendText(" of ");
+                    footerParagraph.AppendField("NumPages", FieldType.FieldNumPages);
+                }
+
+                return CreateFileResult(document, "AddField.docx");
+            }
+        }
+
+        public IActionResult UpdateField()
+        {
+            using (FileStream fileStream = new FileStream("Data\\Input.docx", FileMode.Open, FileAccess.Read))
+            {
+                WordDocument document = new WordDocument(fileStream, FormatType.Automatic);
+
+                document.UpdateDocumentFields();
+
+                return CreateFileResult(document, "UpdateField.docx");
+            }
+        }
+
+        public IActionResult UnlinkField()
+        {
+            using (FileStream fileStream = new FileStream("Data\\InputTemplate.docx", FileMode.Open, FileAccess.Read))
+            {
+                WordDocument document = new WordDocument(fileStream, FormatType.Automatic);
+
+                foreach (WSection section in document.Sections)
+                {
+                    foreach (WParagraph paragraph in section.Body.Paragraphs)
+                    {
+                        for (int i = 0; i < paragraph.Items.Count; i++)
+                        {
+                            if (paragraph.Items[i] is WField field)
+                            {
+                                if (field.FieldType == FieldType.FieldDate)
+                                {
+                                    field.Unlink();
+                                }
+                            }
+                        }
+                    }
+                }
+
+                return CreateFileResult(document, "UnlinkField.docx");
+            }
+        }
+
+        private FileStreamResult CreateFileResult(WordDocument document, string fileName)
+        {
+            MemoryStream outputStream = new MemoryStream();
+            document.Save(outputStream, FormatType.Docx);
+            outputStream.Position = 0;
+            return File(outputStream, "application/docx", fileName);
+        }
+
+        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/Fields/Fields.csproj

@@ -0,0 +1,13 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Syncfusion.DocIO.Net.Core" Version="31.1.22" />
+  </ItemGroup>
+
+</Project>

Videos/Fields/Models/ErrorViewModel.cs

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

Videos/Fields/Program.cs

@@ -0,0 +1,36 @@
+namespace Fields
+{
+    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/Fields/Properties/launchSettings.json

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

Videos/Fields/README.md

@@ -0,0 +1,21 @@
+# How to Work with Fields in Word Documents Using the .NET Word Library
+
+This repository provides an example of how to work with fields in a Word document using the **Syncfusion .NET Word Library (DocIO)**. It demonstrates how to add field, update field, and unlink field in a Word document.
+
+## Process behind Field Integration
+
+This sample demonstrates how Word fields can be used to automate dynamic content in documents. Fields act as placeholders that display information such as page numbers, total pages, or dates, and they update automatically when the document changes.
+
+Using the Syncfusion DocIO library, you can:
+
+- Add fields like page numbers into headers or footers for consistent formatting.
+- Update fields to refresh their values after edits or content changes.
+- Unlink fields to convert them into static text when you no longer need dynamic updates.
+
+## 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:
+   - **AddField**: Creates a Word document with page number fields.
+   - **UpdateField**: Updates all fields in the document.
+   - **UnlinkField**: Converts date fields to static text.

Videos/Fields/Views/Home/Index.cshtml

@@ -0,0 +1,21 @@
+@{
+    ViewData["Title"] = "Home Page";
+}
+
+<div>
+    <h2 style="margin-bottom: 20px; font-size: 22px;">Working with Fields in Word Document</h2>
+    <div>
+        <button style="width: 180px; margin-bottom: 20px; height: 40px; display: block; font-size: 18px;"
+                onclick="location.href='@Url.Action("AddField", "Home")'">
+            Add Field
+        </button>
+        <button style="width: 180px; margin-bottom: 20px; height: 40px; display: block; font-size: 18px;"
+                onclick="location.href='@Url.Action("UpdateField", "Home")'">
+            Update Field
+        </button>
+        <button style="width: 180px; margin-bottom: 20px; height: 40px; display: block; font-size: 18px;"
+                onclick="location.href='@Url.Action("UnlinkField", "Home")'">
+            Unlink Field
+        </button>
+    </div>
+</div>

Videos/Fields/Views/Home/Privacy.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/Fields/Views/Shared/Error.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>

Videos/Fields/Views/Shared/_Layout.cshtml

@@ -0,0 +1,49 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>@ViewData["Title"] - Fields</title>
+    <link rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.min.css" />
+    <link rel="stylesheet" href="~/css/site.css" asp-append-version="true" />
+    <link rel="stylesheet" href="~/Fields.styles.css" asp-append-version="true" />
+</head>
+<body>
+    <header>
+        <nav class="navbar navbar-expand-sm navbar-toggleable-sm navbar-light bg-white border-bottom box-shadow mb-3">
+            <div class="container-fluid">
+                <a class="navbar-brand" asp-area="" asp-controller="Home" asp-action="Index">Fields</a>
+                <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target=".navbar-collapse" aria-controls="navbarSupportedContent"
+                        aria-expanded="false" aria-label="Toggle navigation">
+                    <span class="navbar-toggler-icon"></span>
+                </button>
+                <div class="navbar-collapse collapse d-sm-inline-flex justify-content-between">
+                    <ul class="navbar-nav flex-grow-1">
+                        <li class="nav-item">
+                            <a class="nav-link text-dark" asp-area="" asp-controller="Home" asp-action="Index">Home</a>
+                        </li>
+                        <li class="nav-item">
+                            <a class="nav-link text-dark" asp-area="" asp-controller="Home" asp-action="Privacy">Privacy</a>
+                        </li>
+                    </ul>
+                </div>
+            </div>
+        </nav>
+    </header>
+    <div class="container">
+        <main role="main" class="pb-3">
+            @RenderBody()
+        </main>
+    </div>
+
+    <footer class="border-top footer text-muted">
+        <div class="container">
+            &copy; 2025 - Fields - <a asp-area="" asp-controller="Home" asp-action="Privacy">Privacy</a>
+        </div>
+    </footer>
+    <script src="~/lib/jquery/dist/jquery.min.js"></script>
+    <script src="~/lib/bootstrap/dist/js/bootstrap.bundle.min.js"></script>
+    <script src="~/js/site.js" asp-append-version="true"></script>
+    @await RenderSectionAsync("Scripts", required: false)
+</body>
+</html>

Videos/Fields/Views/Shared/_Layout.cshtml.css

@@ -0,0 +1,48 @@
+/* Please see documentation at https://learn.microsoft.com/aspnet/core/client-side/bundling-and-minification
+for details on configuring this project to bundle and minify static web assets. */
+
+a.navbar-brand {
+  white-space: normal;
+  text-align: center;
+  word-break: break-all;
+}
+
+a {
+  color: #0077cc;
+}
+
+.btn-primary {
+  color: #fff;
+  background-color: #1b6ec2;
+  border-color: #1861ac;
+}
+
+.nav-pills .nav-link.active, .nav-pills .show > .nav-link {
+  color: #fff;
+  background-color: #1b6ec2;
+  border-color: #1861ac;
+}
+
+.border-top {
+  border-top: 1px solid #e5e5e5;
+}
+.border-bottom {
+  border-bottom: 1px solid #e5e5e5;
+}
+
+.box-shadow {
+  box-shadow: 0 .25rem .75rem rgba(0, 0, 0, .05);
+}
+
+button.accept-policy {
+  font-size: 1rem;
+  line-height: inherit;
+}
+
+.footer {
+  position: absolute;
+  bottom: 0;
+  width: 100%;
+  white-space: nowrap;
+  line-height: 60px;
+}

Videos/Fields/Views/Shared/_ValidationScriptsPartial.cshtml

@@ -0,0 +1,2 @@
+<script src="~/lib/jquery-validation/dist/jquery.validate.min.js"></script>
+<script src="~/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.min.js"></script>

Videos/Fields/Views/_ViewImports.cshtml

@@ -0,0 +1,3 @@
+@using Fields
+@using Fields.Models
+@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers

Videos/Fields/Views/_ViewStart.cshtml

@@ -0,0 +1,3 @@
+@{
+    Layout = "_Layout";
+}