Initial commit of the ClosedXML library

Establishes the foundational structure, core Excel functionality, and tooling. - Implements base components for cells, ranges, columns, and rows. - Integrates a custom calculation engine with a wide range of Excel functions. - Adds comprehensive support for styling, conditional formatting, data validation, comments, pictures, and charts. - Configures build setup, project metadata (NuGet), and developer guidelines. - Includes editor and Git attributes for consistent code style and line endings.
2026-06-23 11:02:53 -05:00
parent 28bc05cf54
commit 2cd6df6481
1092 changed files with 97270 additions and 408 deletions
@@ -0,0 +1,249 @@
+using System;
+using System.IO;
+using System.Linq;
+using ClosedXML.Excel;
+using NUnit.Framework;
+using ClosedXML_Tests.Utils;
+
+namespace ClosedXML_Tests.Excel
+{
+    /// <summary>
+    ///     Summary description for UnitTest1
+    /// </summary>
+    [TestFixture]
+    public class ColumnTests
+    {
+        [Test]
+        public void ColumnUsed()
+        {
+            var wb = new XLWorkbook();
+            IXLWorksheet ws = wb.Worksheets.Add("Sheet1");
+            ws.Cell(2, 1).SetValue("Test");
+            ws.Cell(3, 1).SetValue("Test");
+
+            IXLRangeColumn fromColumn = ws.Column(1).ColumnUsed();
+            Assert.AreEqual("A2:A3", fromColumn.RangeAddress.ToStringRelative());
+
+            IXLRangeColumn fromRange = ws.Range("A1:A5").FirstColumn().ColumnUsed();
+            Assert.AreEqual("A2:A3", fromRange.RangeAddress.ToStringRelative());
+        }
+
+        [Test]
+        public void CopyColumn()
+        {
+            var wb = new XLWorkbook();
+            IXLWorksheet ws = wb.AddWorksheet("Sheet1");
+            ws.FirstCell().SetValue("Test").Style.Font.SetBold();
+            ws.FirstColumn().CopyTo(ws.Column(2));
+
+            Assert.IsTrue(ws.Cell("B1").Style.Font.Bold);
+        }
+
+        [Test]
+        public void InsertingColumnsBefore1()
+        {
+            var wb = new XLWorkbook();
+            IXLWorksheet ws = wb.Worksheets.Add("Sheet1");
+
+            ws.Columns("1,3").Style.Fill.SetBackgroundColor(XLColor.Red);
+            ws.Column(2).Style.Fill.SetBackgroundColor(XLColor.Yellow);
+            ws.Cell(2, 2).SetValue("X").Style.Fill.SetBackgroundColor(XLColor.Green);
+
+            IXLColumn column1 = ws.Column(1);
+            IXLColumn column2 = ws.Column(2);
+            IXLColumn column3 = ws.Column(3);
+
+            IXLColumn columnIns = ws.Column(1).InsertColumnsBefore(1).First();
+
+            Assert.AreEqual(ws.Style.Fill.BackgroundColor, ws.Column(1).Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(ws.Style.Fill.BackgroundColor, ws.Column(1).Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(ws.Style.Fill.BackgroundColor, ws.Column(1).Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual(XLColor.Red, ws.Column(2).Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, ws.Column(2).Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, ws.Column(2).Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual(XLColor.Yellow, ws.Column(3).Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Green, ws.Column(3).Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Yellow, ws.Column(3).Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual(XLColor.Red, ws.Column(4).Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, ws.Column(4).Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, ws.Column(4).Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual("X", ws.Column(3).Cell(2).GetString());
+
+
+            Assert.AreEqual(ws.Style.Fill.BackgroundColor, columnIns.Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(ws.Style.Fill.BackgroundColor, columnIns.Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(ws.Style.Fill.BackgroundColor, columnIns.Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual(XLColor.Red, column1.Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, column1.Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, column1.Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual(XLColor.Yellow, column2.Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Green, column2.Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Yellow, column2.Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual(XLColor.Red, column3.Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, column3.Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, column3.Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual("X", column2.Cell(2).GetString());
+        }
+
+        [Test]
+        public void InsertingColumnsBefore2()
+        {
+            var wb = new XLWorkbook();
+            IXLWorksheet ws = wb.Worksheets.Add("Sheet1");
+
+            ws.Columns("1,3").Style.Fill.SetBackgroundColor(XLColor.Red);
+            ws.Column(2).Style.Fill.SetBackgroundColor(XLColor.Yellow);
+            ws.Cell(2, 2).SetValue("X").Style.Fill.SetBackgroundColor(XLColor.Green);
+
+            IXLColumn column1 = ws.Column(1);
+            IXLColumn column2 = ws.Column(2);
+            IXLColumn column3 = ws.Column(3);
+
+            IXLColumn columnIns = ws.Column(2).InsertColumnsBefore(1).First();
+
+            Assert.AreEqual(XLColor.Red, ws.Column(1).Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, ws.Column(1).Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, ws.Column(1).Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual(XLColor.Red, ws.Column(2).Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, ws.Column(2).Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, ws.Column(2).Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual(XLColor.Yellow, ws.Column(3).Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Green, ws.Column(3).Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Yellow, ws.Column(3).Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual(XLColor.Red, ws.Column(4).Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, ws.Column(4).Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, ws.Column(4).Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual("X", ws.Column(3).Cell(2).GetString());
+
+
+            Assert.AreEqual(XLColor.Red, columnIns.Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, columnIns.Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, columnIns.Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual(XLColor.Red, column1.Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, column1.Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, column1.Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual(XLColor.Yellow, column2.Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Green, column2.Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Yellow, column2.Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual(XLColor.Red, column3.Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, column3.Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, column3.Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual("X", column2.Cell(2).GetString());
+        }
+
+        [Test]
+        public void InsertingColumnsBefore3()
+        {
+            var wb = new XLWorkbook();
+            IXLWorksheet ws = wb.Worksheets.Add("Sheet1");
+
+            ws.Columns("1,3").Style.Fill.SetBackgroundColor(XLColor.Red);
+            ws.Column(2).Style.Fill.SetBackgroundColor(XLColor.Yellow);
+            ws.Cell(2, 2).SetValue("X").Style.Fill.SetBackgroundColor(XLColor.Green);
+
+            IXLColumn column1 = ws.Column(1);
+            IXLColumn column2 = ws.Column(2);
+            IXLColumn column3 = ws.Column(3);
+
+            IXLColumn columnIns = ws.Column(3).InsertColumnsBefore(1).First();
+
+            Assert.AreEqual(XLColor.Red, ws.Column(1).Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, ws.Column(1).Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, ws.Column(1).Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual(XLColor.Yellow, ws.Column(2).Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Green, ws.Column(2).Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Yellow, ws.Column(2).Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual(XLColor.Yellow, ws.Column(3).Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Green, ws.Column(3).Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Yellow, ws.Column(3).Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual(XLColor.Red, ws.Column(4).Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, ws.Column(4).Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, ws.Column(4).Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual("X", ws.Column(2).Cell(2).GetString());
+
+
+            Assert.AreEqual(XLColor.Yellow, columnIns.Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Green, columnIns.Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Yellow, columnIns.Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual(XLColor.Red, column1.Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, column1.Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, column1.Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual(XLColor.Yellow, column2.Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Green, column2.Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Yellow, column2.Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual(XLColor.Red, column3.Cell(1).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, column3.Cell(2).Style.Fill.BackgroundColor);
+            Assert.AreEqual(XLColor.Red, column3.Cell(3).Style.Fill.BackgroundColor);
+
+            Assert.AreEqual("X", column2.Cell(2).GetString());
+        }
+
+        [Test]
+        public void NoColumnsUsed()
+        {
+            var wb = new XLWorkbook();
+            IXLWorksheet ws = wb.Worksheets.Add("Sheet1");
+            Int32 count = 0;
+
+            foreach (IXLColumn row in ws.ColumnsUsed())
+                count++;
+
+            foreach (IXLRangeColumn row in ws.Range("A1:C3").ColumnsUsed())
+                count++;
+
+            Assert.AreEqual(0, count);
+        }
+
+        [Test]
+        public void UngroupFromAll()
+        {
+            IXLWorksheet ws = new XLWorkbook().AddWorksheet("Sheet1");
+            ws.Columns(1, 2).Group();
+            ws.Columns(1, 2).Ungroup(true);
+        }
+
+        [Test]
+        public void LastColumnUsed()
+        {
+            IXLWorksheet ws = new XLWorkbook().AddWorksheet("Sheet1");
+            ws.Cell("A1").Value = "A1";
+            ws.Cell("B1").Value = "B1";
+            ws.Cell("A2").Value = "A2";
+            var lastCoUsed = ws.LastColumnUsed().ColumnNumber();
+            Assert.AreEqual(2, lastCoUsed);
+        }
+
+        [Test]
+        public void NegativeColumnNumberIsInvalid()
+        {
+            var ws = new XLWorkbook().AddWorksheet("Sheet1") as XLWorksheet;
+
+            var column = new XLColumn(ws, -1);
+
+            Assert.IsFalse(column.RangeAddress.IsValid);
+        }
+    }
+}