[AUTO] Working With Tables Examples Update

working-with-tables/add-a-calculated-column-that-uses-the-if-function-to-categorize-rows-based-on-a-numeric-threshold.cs

@@ -0,0 +1,40 @@
+using Aspose.Cells;
+using System;
+
+class Program
+{
+    static void Main()
+    {
+        // Create a new workbook and get the first worksheet
+        Workbook workbook = new Workbook();
+        Worksheet sheet = workbook.Worksheets[0];
+        Cells cells = sheet.Cells;
+
+        // Populate sample numeric data in column A
+        cells["A1"].PutValue("Value");
+        cells["A2"].PutValue(50);
+        cells["A3"].PutValue(150);
+        cells["A4"].PutValue(80);
+        cells["A5"].PutValue(200);
+
+        // Add header for the calculated column in column B
+        cells["B1"].PutValue("Category");
+
+        // Define the numeric threshold for categorization
+        double threshold = 100;
+
+        // Apply IF formula to each row to categorize based on the threshold
+        for (int row = 2; row <= 5; row++)
+        {
+            // Formula: =IF(A{row}>threshold,"High","Low")
+            string formula = $"=IF(A{row}>{threshold},\"High\",\"Low\")";
+            cells[$"B{row}"].Formula = formula;
+        }
+
+        // Calculate all formulas in the workbook
+        workbook.CalculateFormula();
+
+        // Save the workbook to a file
+        workbook.Save("CalculatedColumn.xlsx");
+    }
+}

working-with-tables/add-a-column-to-a-table-and-set-its-validation-to-a-list-sourced-from-a-table-column.cs

@@ -0,0 +1,65 @@
+using System;
+using Aspose.Cells;
+using Aspose.Cells.Tables;   // Required for ListObject
+
+namespace AsposeCellsTableValidationDemo
+{
+    class Program
+    {
+        static void Main()
+        {
+            try
+            {
+                // Create a new workbook and get the first worksheet
+                Workbook workbook = new Workbook();
+                Worksheet sheet = workbook.Worksheets[0];
+                Cells cells = sheet.Cells;
+
+                // Populate sample data (including the source list column)
+                // Header row
+                cells["A1"].PutValue("ID");
+                cells["B1"].PutValue("Options");   // This column will be the source list
+                cells["C1"].PutValue("Value");
+                cells["D1"].PutValue("Choice");    // Column that will have validation
+
+                // Data rows
+                for (int i = 2; i <= 5; i++)
+                {
+                    cells[$"A{i}"].PutValue(i - 1);                 // ID
+                    cells[$"B{i}"].PutValue($"Option{i - 1}");      // Options (source list)
+                    cells[$"C{i}"].PutValue((i - 1) * 10);          // Some other value
+                    // D column left empty – will receive validation
+                }
+
+                // Add a ListObject (table) that includes the new column D
+                // Table range: A1:D5, hasHeaders = true
+                int tableIndex = sheet.ListObjects.Add("A1", "D5", true);
+                ListObject table = sheet.ListObjects[tableIndex];
+                // Use DisplayName to set the table name (Name property not available in some versions)
+                table.DisplayName = "SampleTable";
+
+                // Define the area for validation: column D (index 3), rows 2‑5 (excluding header)
+                CellArea validationArea = CellArea.CreateCellArea(1, 3, 4, 3); // rows 1‑4 zero‑based, column 3
+
+                // Add validation to the worksheet
+                ValidationCollection validations = sheet.Validations;
+                int validationIndex = validations.Add(validationArea);
+                Validation validation = validations[validationIndex];
+
+                // Configure validation as a list sourced from the "Options" column (B2:B5)
+                validation.Type = ValidationType.List;
+                validation.InCellDropDown = true;
+                validation.Formula1 = "$B$2:$B$5"; // absolute reference to source list range
+
+                // Save the workbook
+                string outputPath = "TableWithDropdownValidation.xlsx";
+                workbook.Save(outputPath);
+                Console.WriteLine($"Workbook saved successfully to '{outputPath}'.");
+            }
+            catch (Exception ex)
+            {
+                Console.WriteLine($"Error: {ex.Message}");
+            }
+        }
+    }
+}

working-with-tables/add-a-comment-to-the-table-object-describing-its-purpose-and-retrieve-the-comment-text-programmatically.cs

@@ -0,0 +1,34 @@
+using System;
+using Aspose.Cells;
+using Aspose.Cells.Tables;
+
+class ListObjectCommentDemo
+{
+    static void Main()
+    {
+        // Create a new workbook and get the first worksheet
+        Workbook workbook = new Workbook();
+        Worksheet worksheet = workbook.Worksheets[0];
+
+        // Populate sample data for the table
+        worksheet.Cells["A1"].PutValue("ID");
+        worksheet.Cells["B1"].PutValue("Value");
+        worksheet.Cells["A2"].PutValue(1);
+        worksheet.Cells["B2"].PutValue(100);
+        worksheet.Cells["A3"].PutValue(2);
+        worksheet.Cells["B3"].PutValue(200);
+
+        // Add a ListObject (table) that covers the data range A1:B3
+        int listIndex = worksheet.ListObjects.Add(0, 0, 2, 1, true);
+        ListObject table = worksheet.ListObjects[listIndex];
+
+        // Set a comment describing the purpose of the table
+        table.Comment = "This table stores IDs and their corresponding values.";
+
+        // Retrieve the comment text programmatically and display it
+        Console.WriteLine("Table Comment: " + table.Comment);
+
+        // Save the workbook
+        workbook.Save("ListObjectWithComment.xlsx", SaveFormat.Xlsx);
+    }
+}

working-with-tables/add-a-new-row-to-a-table-and-populate-it-with-values-from-a-dictionary-object.cs

@@ -0,0 +1,81 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using Aspose.Cells;
+using Aspose.Cells.Tables;
+
+namespace AsposeCellsTableExample
+{
+    class Program
+    {
+        static void Main()
+        {
+            try
+            {
+                // Create a new workbook and get the first worksheet
+                Workbook workbook = new Workbook();
+                Worksheet worksheet = workbook.Worksheets[0];
+                Cells cells = worksheet.Cells;
+
+                // Populate header and a couple of data rows to form a table
+                cells["A1"].PutValue("ID");
+                cells["B1"].PutValue("Product");
+                cells["C1"].PutValue("Price");
+
+                cells["A2"].PutValue(1);
+                cells["B2"].PutValue("Laptop");
+                cells["C2"].PutValue(999.99m);
+
+                cells["A3"].PutValue(2);
+                cells["B3"].PutValue("Monitor");
+                cells["C3"].PutValue(249.99m);
+
+                // Create a ListObject (Excel table) covering the data range
+                int tableIndex = worksheet.ListObjects.Add("A1", "C3", true);
+                ListObject table = worksheet.ListObjects[tableIndex];
+
+                // Dictionary containing values for the new row
+                var newRowData = new Dictionary<string, object>
+                {
+                    { "ID", 3 },
+                    { "Product", "Keyboard" },
+                    { "Price", 49.99m }
+                };
+
+                // Determine the row offset for the new row (append at the end)
+                // DataRange includes the header row, so subtract 1 to get existing data rows count
+                int newRowOffset = table.DataRange.RowCount - 1;
+
+                // Populate each column using the dictionary values
+                foreach (KeyValuePair<string, object> kvp in newRowData)
+                {
+                    // Find the column index by header name
+                    int columnIndex = -1;
+                    for (int i = 0; i < table.ListColumns.Count; i++)
+                    {
+                        if (string.Equals(table.ListColumns[i].Name, kvp.Key, StringComparison.OrdinalIgnoreCase))
+                        {
+                            columnIndex = i;
+                            break;
+                        }
+                    }
+
+                    // If the column exists, put the value; otherwise ignore
+                    if (columnIndex >= 0)
+                    {
+                        table.PutCellValue(newRowOffset, columnIndex, kvp.Value);
+                    }
+                }
+
+                // Save the workbook
+                string outputPath = "TableWithNewRow.xlsx";
+                workbook.Save(outputPath);
+                Console.WriteLine($"Workbook saved to {Path.GetFullPath(outputPath)}");
+            }
+            catch (Exception ex)
+            {
+                Console.WriteLine($"Error: {ex.Message}");
+            }
+        }
+    }
+}

working-with-tables/add-a-slicer-linked-to-a-table-column-and-configure-it-to-allow-multiselection-for-flexible-filtering.cs

@@ -0,0 +1,67 @@
+using System;
+using System.IO;
+using Aspose.Cells;
+using Aspose.Cells.Slicers;
+using Aspose.Cells.Tables;
+
+namespace AsposeCellsSlicerExample
+{
+    public class MultiSelectSlicerDemo
+    {
+        public static void Run()
+        {
+            try
+            {
+                // Create a new workbook and get the first worksheet
+                Workbook workbook = new Workbook();
+                Worksheet sheet = workbook.Worksheets[0];
+
+                // Populate worksheet with sample data for the table
+                sheet.Cells["A1"].PutValue("Category");
+                sheet.Cells["B1"].PutValue("Value");
+                sheet.Cells["A2"].PutValue("A");
+                sheet.Cells["B2"].PutValue(10);
+                sheet.Cells["A3"].PutValue("B");
+                sheet.Cells["B3"].PutValue(20);
+                sheet.Cells["A4"].PutValue("A");
+                sheet.Cells["B4"].PutValue(30);
+                sheet.Cells["A5"].PutValue("C");
+                sheet.Cells["B5"].PutValue(40);
+
+                // Add a table that covers the data range (A1:B5)
+                int tableIndex = sheet.ListObjects.Add(0, 0, 4, 1, true);
+                ListObject table = sheet.ListObjects[tableIndex];
+                table.TableStyleType = TableStyleType.TableStyleMedium2;
+
+                // Add a slicer linked to the first column ("Category") of the table
+                // Placed with its upper‑left corner at row 6, column 2 (cell B6)
+                SlicerCollection slicers = sheet.Slicers;
+                int slicerIndex = slicers.Add(table, table.ListColumns[0], 6, 2);
+                Slicer slicer = slicers[slicerIndex];
+
+                // Configure slicer appearance (optional)
+                slicer.Caption = "Category Filter";
+                slicer.NumberOfColumns = 2; // layout with two columns for easier multi‑selection
+
+                // Use Shape properties instead of obsolete WidthPixel/HeightPixel
+                slicer.Shape.Width = 200;   // width in points
+                slicer.Shape.Height = 150;  // height in points
+
+                // Save the workbook
+                string outputPath = "MultiSelectSlicerDemo.xlsx";
+                workbook.Save(outputPath);
+                Console.WriteLine($"Workbook saved to '{Path.GetFullPath(outputPath)}'.");
+            }
+            catch (Exception ex)
+            {
+                Console.Error.WriteLine($"Error: {ex.Message}");
+            }
+        }
+
+        // Entry point required for console application
+        public static void Main(string[] args)
+        {
+            Run();
+        }
+    }
+}

working-with-tables/add-a-slicer-linked-to-a-table-column-to-provide-interactive-filtering-in-the-worksheet.cs

@@ -0,0 +1,51 @@
+using Aspose.Cells;
+using Aspose.Cells.Slicers;
+using Aspose.Cells.Tables;
+
+namespace AsposeCellsSlicerDemo
+{
+    public class Program
+    {
+        public static void Main()
+        {
+            // Create a new workbook and get the first worksheet
+            Workbook workbook = new Workbook();
+            Worksheet sheet = workbook.Worksheets[0];
+
+            // Populate sample data for the table (A1:B5)
+            sheet.Cells["A1"].PutValue("Category");
+            sheet.Cells["B1"].PutValue("Amount");
+            sheet.Cells["A2"].PutValue("Food");
+            sheet.Cells["B2"].PutValue(120);
+            sheet.Cells["A3"].PutValue("Drink");
+            sheet.Cells["B3"].PutValue(80);
+            sheet.Cells["A4"].PutValue("Food");
+            sheet.Cells["B4"].PutValue(150);
+            sheet.Cells["A5"].PutValue("Snack");
+            sheet.Cells["B5"].PutValue(60);
+
+            // Convert the range into a ListObject (table)
+            // Add table covering A1:B5 (true indicates the range has headers)
+            int tableIndex = sheet.ListObjects.Add("A1", "B5", true);
+            ListObject table = sheet.ListObjects[tableIndex];
+            table.TableStyleType = TableStyleType.TableStyleMedium2; // optional styling
+
+            // Add a slicer linked to the "Category" column of the table
+            // Use zero‑based row and column indices for the upper‑left corner of the slicer
+            // Here we place the slicer starting at row 7 (index 6) and column 2 (index 1)
+            SlicerCollection slicers = sheet.Slicers;
+            int slicerIndex = slicers.Add(table, table.ListColumns[0], 6, 1);
+            Slicer slicer = slicers[slicerIndex];
+
+            // Optional: customize slicer appearance
+            slicer.Caption = "Category Filter";
+            slicer.NumberOfColumns = 1;
+            slicer.StyleType = SlicerStyleType.SlicerStyleLight1;
+            slicer.WidthPixel = 150;
+            slicer.HeightPixel = 120;
+
+            // Save the workbook with the slicer
+            workbook.Save("SlicerLinkedToTable.xlsx");
+        }
+    }
+}