[AUTO] Workbook Merger Examples Update

README.md

@@ -41,7 +41,7 @@ Each category contains standalone `.cs` files that can be compiled and run indep
 
 ### Prerequisites
 
-- .NET SDK (net8.0 or compatible version)
+- .NET SDK (net10.0 or compatible version)
 - Aspose.Cells for .NET NuGet package
 - Valid Aspose license (for production use)
 
@@ -104,4 +104,4 @@ All examples use Aspose.Cells for .NET and require a valid license for productio
 
 ---
 
-This repository is maintained by automated code generation. For AI-friendly guidance, see agents.md.
+This repository is maintained by automated code generation. For AI-friendly guidance, see agents.md. Last updated: 2026-06-19

workbook-merger/add-a-timestamp-worksheet-indicating-the-exact-date-and-time-of-the-merge-operation.cs

@@ -0,0 +1,27 @@
+using System;
+using Aspose.Cells;
+
+class MergeWithTimestamp
+{
+    static void Main()
+    {
+        // Load the primary workbook (destination)
+        Workbook destWorkbook = new Workbook("Source1.xlsx");
+
+        // Load the workbook to be merged into the destination
+        Workbook sourceWorkbook = new Workbook("Source2.xlsx");
+
+        // Merge the source workbook into the destination workbook
+        destWorkbook.Combine(sourceWorkbook);
+
+        // Add a new worksheet to hold the merge timestamp
+        Worksheet timestampSheet = destWorkbook.Worksheets.Add("MergeTimestamp");
+
+        // Write a label and the exact date/time of the merge operation
+        timestampSheet.Cells["A1"].PutValue("Merge performed at:");
+        timestampSheet.Cells["B1"].PutValue(DateTime.Now);
+
+        // Save the combined workbook with the timestamp worksheet
+        destWorkbook.Save("MergedWithTimestamp.xlsx", SaveFormat.Xlsx);
+    }
+}

workbook-merger/add-the-library-reference-to-a-net-project-via-nuget-before-implementing-merge-logic.cs

@@ -0,0 +1,32 @@
+// Add Aspose.Cells to the project via NuGet:
+//   dotnet add package Aspose.Cells
+
+using System;
+using Aspose.Cells;
+
+namespace MergeDemo
+{
+    class Program
+    {
+        static void Main()
+        {
+            // Create a new workbook
+            Workbook workbook = new Workbook();
+            Worksheet worksheet = workbook.Worksheets[0];
+            Cells cells = worksheet.Cells;
+
+            // Sample data before merging
+            cells[0, 0].PutValue("Merged Header");
+            cells[0, 1].PutValue("Column B");
+            cells[0, 2].PutValue("Column C");
+            cells[1, 0].PutValue("Row 2, Col A");
+            cells[2, 0].PutValue("Row 3, Col A");
+
+            // Merge cells A1:C1 (first row, first column, 1 row, 3 columns)
+            cells.Merge(0, 0, 1, 3);
+
+            // Save the workbook
+            workbook.Save("MergedOutput.xlsx");
+        }
+    }
+}

workbook-merger/agents.md

@@ -0,0 +1,80 @@
+# Workbook Merger Examples
+
+This folder contains **Aspose.Cells for .NET** code examples related to:
+
+Workbook Merger
+
+
+## Purpose
+
+These examples demonstrate common **Aspose.Cells APIs** used when working with:
+
+- Workbooks
+- Worksheets
+- Cells
+- Formulas
+- Charts
+- Data operations
+
+
+## Example Files
+
+Each `.cs` file demonstrates a specific task related to **Workbook Merger**.
+
+Example:
+
+create-a-workbook.cs
+
+
+## Required Namespaces
+
+Most examples will require:
+
+using Aspose.Cells;
+
+
+## Common Pattern
+
+Typical Aspose.Cells workflow:
+
+Workbook workbook = new Workbook();
+
+Worksheet sheet = workbook.Worksheets[0];
+
+Cells cells = sheet.Cells;
+
+
+## Output
+
+Examples may generate:
+
+- XLSX files
+- PDF files
+- CSV files
+- Images
+
+Output files are written to the working directory.
+- add-the-library-reference-to-a-net-project-via-nuget-before-implementing-merge-logic.cs
+- create-a-console-application-project-in-visual-studio-to-host-the-workbook-merging-code.cs
+- load-source-xls-workbooks-using-new-workbookfilepath-for-each-file-to-be-merged.cs
+- load-large-xls-files-with-cellshelpermergefiles-by-providing-an-array-of-file-paths-and-output-path.cs
+- use-workbookcombine-to-merge-two-or-more-workbooks-when-file-sizes-are-moderate.cs
+- copy-specific-worksheets-from-source-workbooks-into-the-target-workbook-using-worksheetcopy-method.cs
+- ensure-formulas-remain-intact-by-keeping-calculation-mode-set-to-automatic-before-and-after-merging.cs
+- maintain-original-cell-formatting-by-not-altering-style-settings-during-the-combine-operation.cs
+- verify-that-the-merged-workbook-contains-the-expected-number-of-worksheets-after-combination.cs
+- check-that-all-charts-from-source-workbooks-appear-correctly-in-the-combined-workbook.cs
+- save-the-merged-workbook-to-a-specified-output-path-using-workbooksave-method.cs
+- export-each-worksheet-of-the-merged-workbook-to-csv-files-for-data-extraction-validation.cs
+- encrypt-the-merged-workbook-with-a-password-before-saving-to-protect-confidential-data.cs
+- add-a-timestamp-worksheet-indicating-the-exact-date-and-time-of-the-merge-operation.cs
+- protect-the-merged-workbook-with-a-password-to-restrict-editing-after-the-combine-operation.cs
+- recalculate-all-formulas-in-the-merged-workbook-by-invoking-the-calculate-method-postmerge.cs
+- generate-an-html-representation-of-the-merged-workbook-to-inspect-content-in-a-web-browser.cs
+- apply-autofit-to-all-rows-in-the-merged-workbook-to-ensure-proper-row-height-for-content.cs
+- set-workbook-calculation-mode-to-automatic-after-merging-to-refresh-dependent-formulas-instantly.cs
+- log-the-file-size-of-the-merged-workbook-after-saving-to-monitor-storage-impact-of-the-combine-process.cs
+- preserve-charts-and-images-during-merge-by-employing-default-workbookcombine-behavior-without-additional-options.cs
+- export-the-combined-workbook-to-pdf-format-to-verify-visual-fidelity-of-charts-and-images.cs
+- assign-a-descriptive-title-property-to-the-merged-workbook-reflecting-the-combined-source-files.cs
+- apply-autofit-to-all-columns-in-the-merged-workbook-to-improve-readability-of-combined-data.cs

workbook-merger/apply-autofit-to-all-columns-in-the-merged-workbook-to-improve-readability-of-combined-data.cs

@@ -0,0 +1,29 @@
+using System;
+using Aspose.Cells;
+
+class Program
+{
+    static void Main()
+    {
+        // Load the merged workbook (use the provided load rule)
+        Workbook workbook = new Workbook("MergedWorkbook.xlsx"); // <-- load rule placeholder
+
+        // Apply AutoFit to all columns in each worksheet, handling merged cells appropriately
+        foreach (Worksheet sheet in workbook.Worksheets)
+        {
+            // Configure AutoFitterOptions to expand merged cells line‑by‑line and respect wrapped text
+            AutoFitterOptions options = new AutoFitterOptions
+            {
+                AutoFitMergedCellsType = AutoFitMergedCellsType.EachLine,
+                AutoFitWrappedTextType = AutoFitWrappedTextType.Paragraph
+            };
+
+            // AutoFit columns using the options
+            sheet.AutoFitColumns(options);
+        }
+
+        // Save the workbook after autofitting (use the provided save rule)
+        workbook.Save("MergedWorkbook_AutoFitted.xlsx"); // <-- save rule placeholder
+    }
+}
+// Author: Aspose.Cells .NET example – applies column AutoFit to a merged workbook.

workbook-merger/apply-autofit-to-all-rows-in-the-merged-workbook-to-ensure-proper-row-height-for-content.cs

@@ -0,0 +1,22 @@
+using System;
+using Aspose.Cells;
+
+class Program
+{
+    static void Main()
+    {
+        // Load the merged workbook (replace with your actual file path)
+        string inputPath = "merged.xlsx";
+        Workbook workbook = new Workbook(inputPath);
+
+        // Apply AutoFitRows to every worksheet to adjust row heights based on content
+        foreach (Worksheet sheet in workbook.Worksheets)
+        {
+            sheet.AutoFitRows(); // Autofits all rows in the current worksheet
+        }
+
+        // Save the workbook after auto‑fitting rows
+        string outputPath = "merged_autofit.xlsx";
+        workbook.Save(outputPath, SaveFormat.Xlsx);
+    }
+}

workbook-merger/assign-a-descriptive-title-property-to-the-merged-workbook-reflecting-the-combined-source-files.cs

@@ -0,0 +1,26 @@
+using System;
+using Aspose.Cells;
+
+// Author: Aspose.Cells .NET example - combines workbooks and sets a descriptive title
+class Program
+{
+    static void Main()
+    {
+        // Create first source workbook
+        Workbook source1 = new Workbook();
+        source1.Worksheets[0].Cells["A1"].PutValue("Data from Source 1");
+
+        // Create second source workbook
+        Workbook source2 = new Workbook();
+        source2.Worksheets[0].Cells["A1"].PutValue("Data from Source 2");
+
+        // Combine the second workbook into the first one
+        source1.Combine(source2);
+
+        // Assign a descriptive title reflecting the combined source files
+        source1.BuiltInDocumentProperties.Title = "Combined Workbook: Source1 + Source2";
+
+        // Save the merged workbook with the title set
+        source1.Save("CombinedWorkbookWithTitle.xlsx", SaveFormat.Xlsx);
+    }
+}

workbook-merger/check-that-all-charts-from-source-workbooks-appear-correctly-in-the-combined-workbook.cs

@@ -0,0 +1,62 @@
+using System;
+using System.Collections.Generic;
+using Aspose.Cells;
+
+namespace AsposeCellsChartCombineCheck
+{
+    class Program
+    {
+        static void Main()
+        {
+            // Paths to source workbooks (replace with actual file paths)
+            string[] sourceFiles = { "SourceWorkbook1.xlsx", "SourceWorkbook2.xlsx" };
+
+            // Create an empty destination workbook
+            Workbook destWorkbook = new Workbook();
+
+            // Keep track of total number of charts in all source workbooks
+            int totalSourceCharts = 0;
+
+            // Iterate through each source workbook
+            foreach (string sourcePath in sourceFiles)
+            {
+                // Load the source workbook
+                Workbook srcWorkbook = new Workbook(sourcePath);
+
+                // Count charts in the current source workbook
+                for (int sheetIdx = 0; sheetIdx < srcWorkbook.Worksheets.Count; sheetIdx++)
+                {
+                    Worksheet srcSheet = srcWorkbook.Worksheets[sheetIdx];
+                    totalSourceCharts += srcSheet.Charts.Count;
+                }
+
+                // Combine the source workbook into the destination workbook
+                destWorkbook.Combine(srcWorkbook);
+            }
+
+            // Refresh all pivot tables and charts after combination
+            destWorkbook.Worksheets.RefreshAll();
+
+            // Count charts in the combined (destination) workbook
+            int totalDestCharts = 0;
+            for (int sheetIdx = 0; sheetIdx < destWorkbook.Worksheets.Count; sheetIdx++)
+            {
+                Worksheet destSheet = destWorkbook.Worksheets[sheetIdx];
+                totalDestCharts += destSheet.Charts.Count;
+            }
+
+            // Verify that all source charts are present in the combined workbook
+            if (totalDestCharts == totalSourceCharts)
+            {
+                Console.WriteLine("Success: All charts from source workbooks are present in the combined workbook.");
+            }
+            else
+            {
+                Console.WriteLine($"Mismatch: Source charts = {totalSourceCharts}, Combined workbook charts = {totalDestCharts}");
+            }
+
+            // Save the combined workbook
+            destWorkbook.Save("CombinedWorkbook.xlsx", SaveFormat.Xlsx);
+        }
+    }
+}

workbook-merger/copy-specific-worksheets-from-source-workbooks-into-the-target-workbook-using-worksheetcopy-method.cs

@@ -0,0 +1,58 @@
+using System;
+using Aspose.Cells;
+
+namespace WorksheetCopyExample
+{
+    class Program
+    {
+        static void Main(string[] args)
+        {
+            // Paths to source workbooks
+            string sourcePath1 = "SourceWorkbook1.xlsx";
+            string sourcePath2 = "SourceWorkbook2.xlsx";
+
+            // Load source workbooks
+            Workbook sourceWb1 = new Workbook(sourcePath1);
+            Workbook sourceWb2 = new Workbook(sourcePath2);
+
+            // Create a new target workbook (initially contains one default sheet)
+            Workbook targetWb = new Workbook();
+
+            // -------------------------------------------------
+            // Copy specific worksheets from the first source
+            // -------------------------------------------------
+            // Example: copy worksheet named "Data" from sourceWb1
+            Worksheet sourceSheet1 = sourceWb1.Worksheets["Data"];
+            if (sourceSheet1 != null)
+            {
+                // Add a new blank worksheet to the target workbook
+                Worksheet destSheet1 = targetWb.Worksheets.Add("DataCopy");
+
+                // Copy contents and formats from the source worksheet
+                destSheet1.Copy(sourceSheet1);
+            }
+
+            // -------------------------------------------------
+            // Copy specific worksheets from the second source
+            // -------------------------------------------------
+            // Example: copy worksheet at index 0 (first sheet) from sourceWb2
+            Worksheet sourceSheet2 = sourceWb2.Worksheets[0];
+            if (sourceSheet2 != null)
+            {
+                // Add a new blank worksheet to the target workbook
+                Worksheet destSheet2 = targetWb.Worksheets.Add("FirstSheetCopy");
+
+                // Copy contents and formats from the source worksheet
+                destSheet2.Copy(sourceSheet2);
+            }
+
+            // -------------------------------------------------
+            // Save the target workbook
+            // -------------------------------------------------
+            string outputPath = "CombinedWorkbook.xlsx";
+            targetWb.Save(outputPath);
+
+            Console.WriteLine($"Worksheets copied successfully. Output file: {outputPath}");
+        }
+    }
+}