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,118 @@
+using ClosedXML.Excel;
+using NUnit.Framework;
+using System.Globalization;
+using System.IO;
+using System.Linq;
+using System.Threading;
+
+namespace ClosedXML_Tests.Excel.ConditionalFormats
+{
+    [TestFixture]
+    public class ConditionalFormatTests
+    {
+        [Test]
+        public void MaintainConditionalFormattingOrder()
+        {
+            using (var stream = TestHelper.GetStreamFromResource(TestHelper.GetResourcePath(@"Other\StyleReferenceFiles\ConditionalFormattingOrder\inputfile.xlsx")))
+            using (var ms = new MemoryStream())
+            {
+                TestHelper.CreateAndCompare(() =>
+                {
+                    var wb = new XLWorkbook(stream);
+                    wb.SaveAs(ms);
+                    return wb;
+                }, @"Other\StyleReferenceFiles\ConditionalFormattingOrder\ConditionalFormattingOrder.xlsx");
+            }
+        }
+
+        [TestCase(true, 7)]
+        [TestCase(false, 8)]
+        public void SaveOptionAffectsConsolidationConditionalFormatRanges(bool consolidateConditionalFormatRanges, int expectedCount)
+        {
+            var options = new SaveOptions
+            {
+                ConsolidateConditionalFormatRanges = consolidateConditionalFormatRanges
+            };
+
+            var wb = new XLWorkbook();
+            var ws = wb.AddWorksheet("Sheet");
+
+            ws.Range("D2:D3").AddConditionalFormat().DataBar(XLColor.Red).LowestValue().HighestValue();
+            ws.Range("B2:B3").AddConditionalFormat().DataBar(XLColor.Red).LowestValue().HighestValue();
+            ws.Range("E2:E6").AddConditionalFormat().ColorScale().LowestValue(XLColor.Red).HighestValue(XLColor.Blue);
+            ws.Range("F2:F6").AddConditionalFormat().ColorScale().LowestValue(XLColor.Red).HighestValue(XLColor.Blue);
+            ws.Range("G2:G7").AddConditionalFormat().WhenIsUnique().Fill.SetBackgroundColor(XLColor.Blue);
+            ws.Range("H2:H7").AddConditionalFormat().WhenIsUnique().Fill.SetBackgroundColor(XLColor.Blue);
+            ws.Range("I2:I6").AddConditionalFormat().WhenContains("test");
+            ws.Range("J2:J6").AddConditionalFormat().WhenContains("test");
+            using (var ms = new MemoryStream())
+            {
+                wb.SaveAs(ms, options);
+                var wb_saved = new XLWorkbook(ms);
+                Assert.AreEqual(expectedCount, wb_saved.Worksheet("Sheet").ConditionalFormats.Count());
+            }
+        }
+
+        [TestCase(true, 1)]
+        [TestCase(false, 2)]
+        public void SaveOptionAffectsConsolidationDataValidationRanges(bool consolidateDataValidationRanges, int expectedCount)
+        {
+            var options = new SaveOptions
+            {
+                ConsolidateDataValidationRanges = consolidateDataValidationRanges
+            };
+
+            var wb = new XLWorkbook();
+            var ws = wb.AddWorksheet("Sheet");
+            ws.Range("C2:C5").SetDataValidation().Decimal.Between(1, 5);
+            ws.Range("D2:D5").SetDataValidation().Decimal.Between(1, 5);
+
+            using (var ms = new MemoryStream())
+            {
+                wb.SaveAs(ms, options);
+                var wb_saved = new XLWorkbook(ms);
+                Assert.AreEqual(expectedCount, wb_saved.Worksheet("Sheet").DataValidations.Count());
+            }
+        }
+
+        [TestCase("en-US")]
+        [TestCase("fr-FR")]
+        [TestCase("ru-RU")]
+        public void SaveConditionalFormat_CultureIndependent(string culture)
+        {
+            using (var ms = new MemoryStream())
+            {
+                var expectedValue = 1.5;
+                Thread.CurrentThread.CurrentCulture = CultureInfo.GetCultureInfo(culture);
+                using (var wb = new XLWorkbook())
+                {
+                    var ws = wb.AddWorksheet();
+                    var i = 1;
+                    ws.Cell(i++, 1).AddConditionalFormat().WhenEquals(expectedValue).Fill.SetBackgroundColor(XLColor.Red);
+                    ws.Cell(i++, 1).AddConditionalFormat().WhenNotEquals(expectedValue).Fill.SetBackgroundColor(XLColor.Red);
+                    ws.Cell(i++, 1).AddConditionalFormat().WhenGreaterThan(expectedValue).Fill.SetBackgroundColor(XLColor.Red);
+                    ws.Cell(i++, 1).AddConditionalFormat().WhenLessThan(expectedValue).Fill.SetBackgroundColor(XLColor.Red);
+                    ws.Cell(i++, 1).AddConditionalFormat().WhenEqualOrGreaterThan(expectedValue).Fill.SetBackgroundColor(XLColor.Red);
+                    ws.Cell(i++, 1).AddConditionalFormat().WhenEqualOrLessThan(expectedValue).Fill.SetBackgroundColor(XLColor.Red);
+                    ws.Cell(i++, 1).AddConditionalFormat().WhenBetween(expectedValue, expectedValue).Fill.SetBackgroundColor(XLColor.Red);
+                    ws.Cell(i++, 1).AddConditionalFormat().WhenNotBetween(expectedValue, expectedValue).Fill.SetBackgroundColor(XLColor.Red);
+
+                    wb.SaveAs(ms);
+                }
+
+                using (var wb = new XLWorkbook(ms))
+                {
+                    var ws = wb.Worksheets.First();
+
+                    var conditionalFormatValues = ws.ConditionalFormats
+                        .SelectMany(cf => cf.Values.Values)
+                        .Select(v => v.Value)
+                        .Distinct();
+
+                    Assert.AreEqual(1, conditionalFormatValues.Count());
+                    Assert.AreEqual("1.5", conditionalFormatValues.Single());
+                }
+            }
+        }
+    }
+}