Merge pull request #98 from aspose-cells/v3/globalization-and-localization

[AUTO] Globalization and Localization Examples Update

Author: yasiraspose

globalization-and-localization/add-subtotal-rows-to-the-worksheet-after-assigning-custom-globalizationsettings-verifying-localized-total-labels.cs

@@ -0,0 +1,80 @@
+using System;
+using Aspose.Cells;
+using Aspose.Cells.Pivot;
+
+namespace AsposeCellsSubtotalDemo
+{
+    // Custom globalization settings that overrides the total name for the SUM function
+    public class CustomGlobalizationSettings : SettableGlobalizationSettings
+    {
+        public override string GetTotalName(ConsolidationFunction functionType)
+        {
+            // Return a custom label for SUM totals; other functions use the base implementation
+            if (functionType == ConsolidationFunction.Sum)
+                return "Custom Sum Total";
+            return base.GetTotalName(functionType);
+        }
+    }
+
+    public class Program
+    {
+        public static void Main()
+        {
+            // Create a new workbook and get the first worksheet
+            Workbook workbook = new Workbook();
+            Worksheet worksheet = workbook.Worksheets[0];
+            Cells cells = worksheet.Cells;
+
+            // Populate sample data (Category | Value)
+            cells["A1"].PutValue("Category");
+            cells["B1"].PutValue("Value");
+            cells["A2"].PutValue("A");
+            cells["B2"].PutValue(10);
+            cells["A3"].PutValue("A");
+            cells["B3"].PutValue(20);
+            cells["A4"].PutValue("B");
+            cells["B4"].PutValue(30);
+            cells["A5"].PutValue("B");
+            cells["B5"].PutValue(40);
+            cells["A6"].PutValue("C");
+            cells["B6"].PutValue(50);
+
+            // Assign the custom globalization settings to the workbook
+            workbook.Settings.GlobalizationSettings = new CustomGlobalizationSettings();
+
+            // Define the range that contains the data (including header)
+            CellArea dataArea = CellArea.CreateCellArea(0, 0, 5, 1); // rows 0-5, columns 0-1
+
+            // Add subtotal rows:
+            // - Group by column 0 (Category)
+            // - Use SUM function
+            // - Apply subtotal to column 1 (Value)
+            // - Replace existing subtotals, no page breaks, place summary below data
+            cells.Subtotal(
+                dataArea,
+                groupBy: 0,
+                function: ConsolidationFunction.Sum,
+                totalList: new int[] { 1 },
+                replace: true,
+                pageBreaks: false,
+                summaryBelowData: true);
+
+            // Verify that the subtotal label uses the custom total name
+            // Search for the custom label in the worksheet
+            string customLabel = "Custom Sum Total";
+            Cell foundCell = cells.Find(customLabel, null, new FindOptions() { LookInType = LookInType.Values });
+
+            if (foundCell != null)
+            {
+                Console.WriteLine($"Verified custom total label found at {foundCell.Name}: \"{foundCell.StringValue}\"");
+            }
+            else
+            {
+                Console.WriteLine("Custom total label not found. Verification failed.");
+            }
+
+            // Save the workbook
+            workbook.Save("SubtotalWithCustomGlobalization.xlsx");
+        }
+    }
+}

globalization-and-localization/agents.md

@@ -0,0 +1,115 @@
+---
+category: globalization-and-localization
+framework: .NET
+parent: ../agents.md
+version: v2
+---
+
+# Persona
+
+You are a C# developer specializing in globalization, localization, regional settings, and culture-specific workbook processing using Aspose.Cells for .NET.
+
+Generate simple, correct, production-quality examples that demonstrate ONE globalization or localization scenario at a time.
+
+---
+
+# Scope
+
+- Standalone .cs examples
+- One operation per example
+- Fully runnable with dotnet run
+- No external dependencies
+
+---
+
+# Required Namespaces
+
+using System;
+using System.Globalization;
+using Aspose.Cells;
+
+---
+
+# Key APIs
+
+- GlobalizationSettings
+- Workbook.Settings
+- CultureInfo
+- Style.Custom
+- Cell.PutValue()
+
+---
+
+# Common Pattern
+
+1. Create workbook
+2. Configure culture or globalization settings
+3. Add localized data
+4. Format values using regional settings
+5. Save workbook
+6. Print success message
+
+---
+
+# Globalization and Localization Rules
+
+- Demonstrate one localization feature per example
+- Use CultureInfo when culture-specific behavior is required
+- Use deterministic sample data
+- Clearly show the effect of regional settings
+
+---
+
+# Input Strategy
+
+- Do NOT rely on external XLSX files
+- Generate workbook content programmatically
+- Keep examples self-contained
+
+---
+
+# Output Rules
+
+- Always generate output.xlsx
+- Ensure workbook is saved successfully
+- Output files are written to the working directory
+
+---
+
+# Common Tasks
+
+- Apply culture-specific formatting
+- Localize dates and numbers
+- Configure globalization settings
+- Work with regional formats
+- Customize language-specific workbook behavior
+
+---
+
+# Common Mistakes
+
+❌ var workbook = new Workbook();
+✅ Workbook workbook = new Workbook();
+
+❌ Assume formatting behaves the same across cultures
+✅ Explicitly configure culture settings
+
+❌ Workbook workbook = new Workbook("input.xlsx");
+✅ Workbook workbook = new Workbook();
+
+---
+
+# Code Simplicity
+
+- Keep examples concise
+- Avoid unnecessary abstractions
+- Focus on one localization capability per example
+
+---
+
+# General Rules
+
+Refer to the root agents.md for:
+- Boundaries
+- Testing requirements
+- Build and run instructions

globalization-and-localization/apply-custom-number-format-strings-to-percentage-cells-after-loading-the-workbook-with-brazilian-portuguese-cultureinfo.cs

@@ -0,0 +1,41 @@
+using System;
+using System.Globalization;
+using Aspose.Cells;
+
+namespace AsposeCellsPercentageFormatting
+{
+    class Program
+    {
+        static void Main()
+        {
+            // Load the workbook with Brazilian Portuguese culture (pt-BR)
+            LoadOptions loadOptions = new LoadOptions(LoadFormat.Xlsx);
+            loadOptions.CultureInfo = new CultureInfo("pt-BR");
+            Workbook workbook = new Workbook("input.xlsx", loadOptions);
+
+            // Iterate through all cells in the first worksheet
+            Worksheet sheet = workbook.Worksheets[0];
+            Cells cells = sheet.Cells;
+
+            foreach (Cell cell in cells)
+            {
+                // Retrieve the cell's style
+                Style style = cell.GetStyle();
+
+                // Check if the current style is a percentage format
+                if (style.IsPercent)
+                {
+                    // Apply a custom percentage format that respects the culture
+                    // "#,##0.00%" will use the culture's decimal and group separators
+                    style.SetCustom("#,##0.00%", true);
+
+                    // Re-apply the modified style to the cell
+                    cell.SetStyle(style);
+                }
+            }
+
+            // Save the modified workbook
+            workbook.Save("output.xlsx");
+        }
+    }
+}

globalization-and-localization/assign-the-custom-globalizationsettings-instance-to-workbooksettingsglobalizationsettings-before-loading-any-worksheets.cs

@@ -0,0 +1,51 @@
+using System;
+using Aspose.Cells;
+
+// Custom globalization settings derived from GlobalizationSettings
+class CustomGlobalizationSettings : GlobalizationSettings
+{
+    // Override boolean display strings
+    public override string GetBooleanValueString(bool value)
+    {
+        return value ? "ИСТИНА" : "ЛОЖЬ";
+    }
+
+    // Override error value strings
+    public override string GetErrorValueString(string error)
+    {
+        return error switch
+        {
+            "#NAME?"   => "#ИМЯ?",
+            "#DIV/0!" => "#ДЕЛ/0!",
+            "#REF!"   => "#ССЫЛКА!",
+            "#VALUE!" => "#ЗНАЧ!",
+            "#N/A"    => "#Н/Д",
+            "#NUM!"   => "#ЧИСЛО!",
+            "#NULL!"  => "#ПУСТО!",
+            _         => base.GetErrorValueString(error)
+        };
+    }
+}
+
+class Program
+{
+    static void Main()
+    {
+        // Create LoadOptions (no special options needed for this example)
+        LoadOptions loadOptions = new LoadOptions();
+
+        // Load the workbook; at this point no worksheet has been accessed yet
+        Workbook workbook = new Workbook("input.xlsx", loadOptions);
+
+        // Assign the custom globalization settings BEFORE any worksheet is accessed
+        workbook.Settings.GlobalizationSettings = new CustomGlobalizationSettings();
+
+        // Now worksheets can be used safely with the custom settings applied
+        Worksheet sheet = workbook.Worksheets[0];
+        Cell cell = sheet.Cells["A1"];
+        Console.WriteLine($"Cell[0,0] value: {cell.StringValue}");
+
+        // Save the workbook if needed
+        workbook.Save("output.xlsx");
+    }
+}

globalization-and-localization/assign-the-custom-globalizationsettings-to-the-workbook-before-adding-subtotals-to-ensure-localized-labels.cs

@@ -0,0 +1,51 @@
+using System;
+using Aspose.Cells;
+using Aspose.Cells.Pivot;
+
+class Program
+{
+    static void Main()
+    {
+        // Create a new workbook
+        Workbook workbook = new Workbook();
+        Worksheet sheet = workbook.Worksheets[0];
+        Cells cells = sheet.Cells;
+
+        // Populate sample data
+        cells["A1"].PutValue("Category");
+        cells["B1"].PutValue("Amount");
+        cells["A2"].PutValue("A");
+        cells["B2"].PutValue(10);
+        cells["A3"].PutValue("A");
+        cells["B3"].PutValue(20);
+        cells["A4"].PutValue("B");
+        cells["B4"].PutValue(30);
+        cells["A5"].PutValue("B");
+        cells["B5"].PutValue(40);
+
+        // Assign custom globalization settings before adding subtotals
+        workbook.Settings.GlobalizationSettings = new CustomGlobalizationSettings();
+
+        // Define the range for subtotal (rows 0‑4, columns 0‑1)
+        CellArea area = CellArea.CreateCellArea(0, 0, 4, 1);
+
+        // Add subtotal: group by column 0 (Category) and calculate Sum on column 1 (Amount)
+        // Parameters: area, columnIndexToGroup, function, columnsToSubtotal, replace, pageBreaks, summaryBelowData
+        cells.Subtotal(area, 0, ConsolidationFunction.Sum, new int[] { 1 }, true, false, true);
+
+        // Save the workbook
+        workbook.Save("CustomGlobalizationSubtotal.xlsx");
+    }
+
+    // Custom globalization settings to provide localized total label
+    class CustomGlobalizationSettings : GlobalizationSettings
+    {
+        public override string GetTotalName(ConsolidationFunction functionType)
+        {
+            // Return a custom label for the Sum total; fall back to default for others
+            return functionType == ConsolidationFunction.Sum
+                ? "Custom Sum Total"
+                : base.GetTotalName(functionType);
+        }
+    }
+}