Publish linq-reporting category examples (#233)

Author: agent-aspose-words-examples

linq-reporting/AGENTS.md

@@ -2085,7 +2085,7 @@ Use the simplest workflow that satisfies the task.
 ## Build and run contract
 
 - Target framework: `net8.0`
-- Package: `Aspose.Words` `26.7.0`
+- Package: `Aspose.Words` `26.8.0`
 - Package: `Newtonsoft.Json`
 - Package: `System.Text.Encoding.CodePages` `9.0.2`
 
@@ -2101,7 +2101,7 @@ cd ExampleProject
 ### Add required packages
 
 ```bash
-dotnet add package Aspose.Words --version 26.7.0
+dotnet add package Aspose.Words --version 26.8.0
 dotnet add package Newtonsoft.Json
 dotnet add package System.Text.Encoding.CodePages --version 9.0.2
 ```

linq-reporting/README.md

@@ -1,14 +1,14 @@
 # LINQ Reporting Examples for Aspose.Words for .NET
 
-This folder contains the live, publish-ready C# examples for the LINQ Reporting category. Each file is a standalone console example selected from the verified 26.7.0 run.
+This folder contains the live, publish-ready C# examples for the LINQ Reporting category. Each file is a standalone console example selected from the verified 26.8.0 run.
 
 ## Snapshot
 
 - Category: LINQ Reporting
 - Slug: linq-reporting
 - Total examples: 403
 - Publish-ready successful examples: 403 / 403
-- Source run: 20260802_190455_803b68
+- Source run: 20260830_195242_46e1a9
 - LINQ Reporting Workflow examples: 403
 
 ## Category rules that shaped these examples
@@ -23,7 +23,7 @@ This folder contains the live, publish-ready C# examples for the LINQ Reporting
 ## Prerequisites
 
 - .NET SDK 8.0 or later
-- Aspose.Words 26.7.0
+- Aspose.Words 26.8.0
 - Newtonsoft.Json
 - System.Text.Encoding.CodePages 9.0.2
 
@@ -34,7 +34,7 @@ Each file in this folder is a single, standalone `.cs` console example. To run o
 ```bash
 dotnet new console -n ExampleProject --framework net8.0
 cd ExampleProject
-dotnet add package Aspose.Words --version 26.7.0
+dotnet add package Aspose.Words --version 26.8.0
 dotnet add package Newtonsoft.Json
 dotnet add package System.Text.Encoding.CodePages --version 9.0.2
 
@@ -57,7 +57,7 @@ Example:
 # From the repository root
 dotnet new console -n ExampleProject --framework net8.0
 cd ExampleProject
-dotnet add package Aspose.Words --version 26.7.0
+dotnet add package Aspose.Words --version 26.8.0
 dotnet add package Newtonsoft.Json
 dotnet add package System.Text.Encoding.CodePages --version 9.0.2
 
@@ -519,6 +519,6 @@ dotnet run --configuration Release --no-build
 
 ## Notes for maintainers
 
-- This category is 100% publish-ready for the 26.7.0 run.
+- This category is 100% publish-ready for the 26.8.0 run.
 - Preserve file-to-task traceability when updating this folder.
 - Keep examples standalone and bootstrap local inputs inside the example whenever external sources are mentioned.

linq-reporting/access-static-members-of-system-math-inside-an-expression-to-compute-rounded-values-for-fi.cs

@@ -3,81 +3,51 @@
 using Aspose.Words;
 using Aspose.Words.Reporting;
 
-public class Program
+public class InvoiceItem
 {
-    // Simple data model representing a financial record.
-    public class FinancialRecord
-    {
-        public string Description { get; set; } = string.Empty;
-        public double Amount { get; set; }
-    }
+    public string Description { get; set; } = string.Empty;
+    public decimal Amount { get; set; }
+}
 
-    // Wrapper class that will be passed as the root data source.
-    public class ReportModel
-    {
-        public List<FinancialRecord> Items { get; set; } = new();
-    }
+public class ReportModel
+{
+    public List<InvoiceItem> Items { get; set; } = new();
+}
 
+public class Program
+{
     public static void Main()
     {
-        // 1. Prepare sample data.
+        // Prepare sample data.
         var model = new ReportModel
         {
-            Items = new List<FinancialRecord>
+            Items = new List<InvoiceItem>
             {
-                new FinancialRecord { Description = "Consulting", Amount = 1234.5678 },
-                new FinancialRecord { Description = "Software License", Amount = 9876.5432 },
-                new FinancialRecord { Description = "Support", Amount = 250.125 }
+                new InvoiceItem { Description = "Consulting", Amount = 1234.567m },
+                new InvoiceItem { Description = "Software License", Amount = 2500.0m },
+                new InvoiceItem { Description = "Support", Amount = 199.994m }
             }
         };
 
-        // 2. Create a template document programmatically.
-        var templatePath = "Template.docx";
+        // Create a template document in memory.
         var doc = new Document();
         var builder = new DocumentBuilder(doc);
 
-        // Header.
-        builder.Writeln("Financial Report");
-        builder.Writeln("-----------------");
-
-        // Table header (outside the foreach loop).
-        var headerTable = builder.StartTable();
-        builder.InsertCell();
-        builder.Writeln("Description");
-        builder.InsertCell();
-        builder.Writeln("Amount (rounded to 2 decimals)");
-        builder.EndRow();
-        builder.EndTable();
-
-        // Data rows using LINQ Reporting tags.
-        // The foreach block must enclose the entire table that repeats for each item.
+        builder.Writeln("Invoice Report");
         builder.Writeln("<<foreach [item in Items]>>");
-        var dataTable = builder.StartTable();
-        builder.InsertCell();
-        builder.Writeln("<<[item.Description]>>");
-        builder.InsertCell();
-        // Use System.Math.Round static method inside the expression.
-        builder.Writeln("<<[Math.Round(item.Amount, 2)]>>");
-        builder.EndRow();
-        builder.EndTable();
+        // Use System.Math static method to round the amount to 2 decimal places.
+        builder.Writeln("Item: <<[item.Description]>> - Amount: $<<[Math.Round(item.Amount, 2)]>>");
         builder.Writeln("<</foreach>>");
 
-        // Save the template to disk.
-        doc.Save(templatePath);
-
-        // 3. Load the template for reporting.
-        var reportDoc = new Document(templatePath);
-
-        // 4. Configure the ReportingEngine.
+        // Configure the reporting engine.
         var engine = new ReportingEngine();
-        // Allow the engine to access static members of System.Math.
+        // Register System.Math so its static members can be used in expressions.
         engine.KnownTypes.Add(typeof(Math));
 
-        // 5. Build the report.
-        engine.BuildReport(reportDoc, model, "model");
+        // Build the report using the model as the root data source named "model".
+        engine.BuildReport(doc, model, "model");
 
-        // 6. Save the generated report.
-        var outputPath = "Report.docx";
-        reportDoc.Save(outputPath);
+        // Save the generated report.
+        doc.Save("InvoiceReport.docx");
     }
 }

linq-reporting/activate-reportbuildoptions-inlineerrormessages-and-capture-the-boolean-success-flag-from.cs

@@ -2,35 +2,44 @@
 using Aspose.Words;
 using Aspose.Words.Reporting;
 
-public class Program
+namespace AsposeWordsLinqReportingExample
 {
-    public static void Main()
+    // Simple data model used as the root object for the report.
+    public class Person
     {
-        // Create a template document with a LINQ Reporting tag.
-        Document doc = new Document();
-        DocumentBuilder builder = new DocumentBuilder(doc);
-        builder.Writeln("Hello <<[model.Name]>>!");
+        public string Name { get; set; } = string.Empty;
+        public int Age { get; set; }
+    }
 
-        // Prepare the data model.
-        var model = new ReportModel { Name = "World" };
+    public class Program
+    {
+        public static void Main()
+        {
+            // Create a sample data object.
+            var person = new Person
+            {
+                Name = "John Doe",
+                Age = 30
+            };
 
-        // Configure the reporting engine to inline error messages.
-        ReportingEngine engine = new ReportingEngine();
-        engine.Options = ReportBuildOptions.InlineErrorMessages;
+            // Create a new blank document and insert a LINQ Reporting tag.
+            var doc = new Document();
+            var builder = new DocumentBuilder(doc);
+            // The tag references the root object name "person".
+            builder.Writeln("<<[person.Name]>> is <<[person.Age]>> years old.");
 
-        // Build the report and capture the success flag.
-        bool success = engine.BuildReport(doc, model, "model");
+            // Configure the reporting engine to inline error messages.
+            var engine = new ReportingEngine();
+            engine.Options = ReportBuildOptions.InlineErrorMessages;
 
-        // Save the generated report.
-        doc.Save("ReportOutput.docx");
+            // Build the report and capture the success flag.
+            bool success = engine.BuildReport(doc, person, "person");
 
-        // Output the success flag.
-        Console.WriteLine($"BuildReport success: {success}");
-    }
+            // Save the resulting document.
+            doc.Save("ReportOutput.docx");
 
-    // Simple data model class used by the template.
-    public class ReportModel
-    {
-        public string Name { get; set; } = "";
+            // Output the success flag (no interactive input required).
+            Console.WriteLine($"Report build success: {success}");
+        }
     }
 }

linq-reporting/add-bookmarks-inside-list-items-ensuring-they-are-not-placed-within-chart-elements.cs

@@ -1,81 +1,88 @@
 using System;
 using System.Collections.Generic;
 using Aspose.Words;
+using Aspose.Words.Lists;          // For ListTemplate
 using Aspose.Words.Reporting;
+using Aspose.Words.Drawing;
+using Aspose.Words.Drawing.Charts; // For ChartType
 
 public class Program
 {
     public static void Main()
     {
-        // Paths for the template and the generated report.
-        const string templatePath = "Template.docx";
-        const string outputPath = "Report.docx";
+        // Prepare sample data.
+        var model = new ReportModel
+        {
+            Items = new List<Item>
+            {
+                new Item { Title = "First item", BookmarkName = "bmFirst" },
+                new Item { Title = "Second item", BookmarkName = "bmSecond" },
+                new Item { Title = "Third item", BookmarkName = "bmThird" }
+            }
+        };
 
-        // -------------------------------------------------
-        // 1. Create the LINQ Reporting template programmatically.
-        // -------------------------------------------------
-        Document templateDoc = new Document();
-        DocumentBuilder builder = new DocumentBuilder(templateDoc);
+        // -----------------------------------------------------------------
+        // 1. Create the template document programmatically.
+        // -----------------------------------------------------------------
+        var template = new Document();
+        var builder = new DocumentBuilder(template);
 
-        // Create a numbered list that will be used for the items.
-        builder.ListFormat.List = templateDoc.Lists.Add(Aspose.Words.Lists.ListTemplate.NumberDefault);
+        // Title paragraph.
+        builder.Writeln("Report with bookmarks inside list items:");
 
-        // Write the foreach tag that iterates over the Items collection.
+        // Start a numbered list.
+        builder.ListFormat.List = template.Lists.Add(ListTemplate.NumberDefault);
+
+        // LINQ Reporting foreach block iterating over Items.
         builder.Writeln("<<foreach [item in Items]>>");
 
-        // Each iteration is a list paragraph. Insert a bookmark that wraps the item's title.
-        // The bookmark name is taken from the data source (item.BookmarkName).
-        builder.Writeln("<<bookmark [item.BookmarkName]>><<[item.Title]>><</bookmark>>");
+        // Insert a bookmark that wraps the list item text.
+        // The bookmark expression must return a non‑empty string.
+        builder.Writeln("<<bookmark [item.BookmarkName]>>");
+        builder.Writeln("<<[item.Title]>>");
+        builder.Writeln("<</bookmark>>");
 
-        // End the foreach block.
+        // End of foreach block.
         builder.Writeln("<</foreach>>");
 
+        // End the list.
+        builder.ListFormat.RemoveNumbers();
+
+        // Insert a chart after the list – bookmarks are **not** placed inside the chart.
+        builder.Writeln("\nSample chart:");
+        builder.InsertChart(ChartType.Column, 400, 300);
+
         // Save the template to disk.
-        templateDoc.Save(templatePath);
+        const string templatePath = "Template.docx";
+        template.Save(templatePath);
 
-        // -------------------------------------------------
-        // 2. Prepare the data model.
-        // -------------------------------------------------
-        ReportModel model = new ReportModel
+        // -----------------------------------------------------------------
+        // 2. Build the report using the LINQ Reporting engine.
+        // -----------------------------------------------------------------
+        var report = new Document(templatePath);
+        var engine = new ReportingEngine
         {
-            Items = new List<Item>
-            {
-                new Item { Title = "First item", BookmarkName = "bmFirst" },
-                new Item { Title = "Second item", BookmarkName = "bmSecond" },
-                new Item { Title = "Third item", BookmarkName = "bmThird" }
-            }
+            Options = ReportBuildOptions.None
         };
 
-        // -------------------------------------------------
-        // 3. Load the template and build the report.
-        // -------------------------------------------------
-        Document doc = new Document(templatePath);
-        ReportingEngine engine = new ReportingEngine();
+        // The root object name used in the template is "model".
+        engine.BuildReport(report, model, "model");
 
-        // Build the report using the model as the root object named "model".
-        engine.BuildReport(doc, model, "model");
-
-        // -------------------------------------------------
-        // 4. Save the generated report.
-        // -------------------------------------------------
-        doc.Save(outputPath);
+        // Save the final report.
+        report.Save("Report.docx");
     }
 }
 
-// -------------------------------------------------
-// Data model classes.
-// -------------------------------------------------
+// ---------------------------------------------------------------------
+// Data model classes – must be public with public properties.
+// ---------------------------------------------------------------------
 public class ReportModel
 {
-    // Collection of items to be listed.
     public List<Item> Items { get; set; } = new();
 }
 
 public class Item
 {
-    // Text displayed for the list item.
     public string Title { get; set; } = string.Empty;
-
-    // Name of the bookmark that will be placed around the title.
     public string BookmarkName { get; set; } = string.Empty;
 }