Files
ClosedXML/ClosedXML_Tests/Excel/Saving/SavingTests.cs
T
Thom Lamb 2cd6df6481 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

734 lines
25 KiB
C#

using ClosedXML.Excel;
using ClosedXML.Excel.Drawings;
using ClosedXML_Tests.Utils;
using DocumentFormat.OpenXml;
using DocumentFormat.OpenXml.Packaging;
using NUnit.Framework;
using System;
using System.Drawing;
using System.Globalization;
using System.IO;
using System.Linq;
using System.Reflection;
using System.Threading;
namespace ClosedXML_Tests.Excel.Saving
{
[TestFixture]
public class SavingTests
{
[Test]
public void CanSaveEmptyFile()
{
using (var ms = new MemoryStream())
using (var wb = new XLWorkbook())
{
wb.AddWorksheet("Sheet1");
wb.SaveAs(ms);
}
}
[Test]
public void CanSuccessfullySaveFileMultipleTimes()
{
using (var memoryStream = new MemoryStream())
using (var wb = new XLWorkbook())
{
var sheet = wb.Worksheets.Add("TestSheet");
// Comments might cause duplicate VmlDrawing Id's - ensure it's tested:
sheet.Cell(1, 1).Comment.AddText("abc");
wb.SaveAs(memoryStream, validate: true);
for (int i = 1; i <= 3; i++)
{
sheet.Cell(i, 1).Value = "test" + i;
wb.SaveAs(memoryStream, validate: true);
}
}
}
[Test]
public void CanEscape_xHHHH_Correctly()
{
using (var ms = new MemoryStream())
{
using (var wb = new XLWorkbook())
{
var ws = wb.AddWorksheet("Sheet1");
ws.FirstCell().Value = "Reserve_TT_A_BLOCAGE_CAG_x6904_2";
wb.SaveAs(ms);
}
ms.Seek(0, SeekOrigin.Begin);
using (var wb = new XLWorkbook(ms))
{
var ws = wb.Worksheets.First();
Assert.AreEqual("Reserve_TT_A_BLOCAGE_CAG_x6904_2", ws.FirstCell().Value);
}
}
}
[Test]
public void CanSaveFileMultipleTimesAfterDeletingWorksheet()
{
// https://github.com/ClosedXML/ClosedXML/issues/435
using (var ms = new MemoryStream())
{
using (XLWorkbook book1 = new XLWorkbook())
{
book1.AddWorksheet("sheet1");
book1.AddWorksheet("sheet2");
book1.SaveAs(ms);
}
ms.Position = 0;
using (XLWorkbook book2 = new XLWorkbook(ms))
{
var ws = book2.Worksheet(1);
Assert.AreEqual("sheet1", ws.Name);
ws.Delete();
book2.Save();
book2.Save();
}
}
}
[Test]
public void CanSaveAndValidateFileInAnotherCulture()
{
string[] cultures = new string[] { "it", "de-AT" };
foreach (var culture in cultures)
{
Thread.CurrentThread.CurrentCulture = CultureInfo.GetCultureInfo(culture);
using (var wb = new XLWorkbook())
{
var memoryStream = new MemoryStream();
var ws = wb.Worksheets.Add("Sheet1");
wb.SaveAs(memoryStream, true);
}
}
}
[Test]
public void NotSaveCachedValueWhenFlagIsFalse()
{
using (var ms = new MemoryStream())
{
using (XLWorkbook book1 = new XLWorkbook())
{
var sheet = book1.AddWorksheet("sheet1");
sheet.Cell("A1").Value = 123;
sheet.Cell("A2").FormulaA1 = "A1*10";
book1.RecalculateAllFormulas();
var options = new SaveOptions { EvaluateFormulasBeforeSaving = false };
book1.SaveAs(ms, options);
}
ms.Position = 0;
using (XLWorkbook book2 = new XLWorkbook(ms))
{
var ws = book2.Worksheet(1);
Assert.IsNull(ws.Cell("A2").CachedValue);
}
}
}
[Test]
public void SaveCachedValueWhenFlagIsTrue()
{
using (var ms = new MemoryStream())
{
using (XLWorkbook book1 = new XLWorkbook())
{
var sheet = book1.AddWorksheet("sheet1");
sheet.Cell("A1").Value = 123;
sheet.Cell("A2").FormulaA1 = "A1*10";
sheet.Cell("A3").FormulaA1 = "TEXT(A2, \"# ###\")";
var options = new SaveOptions { EvaluateFormulasBeforeSaving = true };
book1.SaveAs(ms, options);
}
ms.Position = 0;
using (XLWorkbook book2 = new XLWorkbook(ms))
{
var ws = book2.Worksheet(1);
Assert.AreEqual(1230, ws.Cell("A2").CachedValue);
Assert.AreEqual("1 230", ws.Cell("A3").CachedValue);
}
}
}
[Test]
public void CanSaveAsCopyReadOnlyFile()
{
using (var original = new TemporaryFile())
{
try
{
using (var copy = new TemporaryFile())
{
// Arrange
using (var wb = new XLWorkbook())
{
var sheet = wb.Worksheets.Add("TestSheet");
wb.SaveAs(original.Path);
}
File.SetAttributes(original.Path, FileAttributes.ReadOnly);
// Act
using (var wb = new XLWorkbook(original.Path))
{
wb.SaveAs(copy.Path);
}
// Assert
Assert.IsTrue(File.Exists(copy.Path));
Assert.IsFalse(File.GetAttributes(copy.Path).HasFlag(FileAttributes.ReadOnly));
}
}
finally
{
// Tear down
File.SetAttributes(original.Path, FileAttributes.Normal);
}
}
}
[Test]
public void CanSaveAsOverwriteExistingFile()
{
using (var existing = new TemporaryFile())
{
// Arrange
File.WriteAllText(existing.Path, "");
// Act
using (var wb = new XLWorkbook())
{
var sheet = wb.Worksheets.Add("TestSheet");
wb.SaveAs(existing.Path);
}
// Assert
Assert.IsTrue(File.Exists(existing.Path));
Assert.Greater(new FileInfo(existing.Path).Length, 0);
}
}
[Test]
public void CannotSaveAsOverwriteExistingReadOnlyFile()
{
using (var existing = new TemporaryFile())
{
try
{
// Arrange
File.WriteAllText(existing.Path, "");
File.SetAttributes(existing.Path, FileAttributes.ReadOnly);
// Act
TestDelegate saveAs = () =>
{
using (var wb = new XLWorkbook())
{
var sheet = wb.Worksheets.Add("TestSheet");
wb.SaveAs(existing.Path);
}
};
// Assert
Assert.Throws(typeof(UnauthorizedAccessException), saveAs);
}
finally
{
// Tear down
File.SetAttributes(existing.Path, FileAttributes.Normal);
}
}
}
[Test]
public void PageBreaksDontDuplicateAtSaving()
{
// https://github.com/ClosedXML/ClosedXML/issues/666
using (var ms = new MemoryStream())
{
using (var wb1 = new XLWorkbook())
{
var ws = wb1.Worksheets.Add("Page Breaks");
ws.PageSetup.PrintAreas.Add("A1:D5");
ws.PageSetup.AddHorizontalPageBreak(2);
ws.PageSetup.AddVerticalPageBreak(2);
wb1.SaveAs(ms);
wb1.Save();
}
using (var wb2 = new XLWorkbook(ms))
{
var ws = wb2.Worksheets.First();
Assert.AreEqual(1, ws.PageSetup.ColumnBreaks.Count);
Assert.AreEqual(1, ws.PageSetup.RowBreaks.Count);
}
}
}
[Test]
public void CanSaveFileWithPictureAndComment()
{
using (var ms = new MemoryStream())
using (var wb = new XLWorkbook())
using (var resourceStream = Assembly.GetAssembly(typeof(ClosedXML_Examples.BasicTable)).GetManifestResourceStream("ClosedXML_Examples.Resources.SampleImage.jpg"))
using (var bitmap = Bitmap.FromStream(resourceStream) as Bitmap)
{
var ws = wb.AddWorksheet("Sheet1");
ws.Cell("D4").Value = "Hello world.";
ws.AddPicture(bitmap, "MyPicture")
.WithPlacement(XLPicturePlacement.FreeFloating)
.MoveTo(50, 50)
.WithSize(200, 200);
ws.Cell("D4").Comment.SetVisible().AddText("This is a comment");
wb.SaveAs(ms);
}
}
[Test]
public void PreserveChartsWhenSaving()
{
using (var stream = TestHelper.GetStreamFromResource(TestHelper.GetResourcePath(@"Other\Charts\PreserveCharts\inputfile.xlsx")))
using (var ms = new MemoryStream())
{
TestHelper.CreateAndCompare(() =>
{
var wb = new XLWorkbook(stream);
wb.SaveAs(ms);
return wb;
}, @"Other\Charts\PreserveCharts\outputfile.xlsx");
}
}
[Test]
public void DeletingAllPicturesRemovesDrawingPart()
{
TestHelper.CreateAndCompare(() =>
{
var stream = TestHelper.GetStreamFromResource(TestHelper.GetResourcePath(@"Examples\ImageHandling\ImageAnchors.xlsx"));
var wb = new XLWorkbook(stream);
foreach (var ws in wb.Worksheets)
{
var pictureNames = ws.Pictures.Select(pic => pic.Name).ToArray();
foreach (var name in pictureNames)
ws.Pictures.Delete(name);
}
return wb;
}, @"Other\Drawings\NoDrawings\outputfile.xlsx");
}
[Test]
[TestCase("xlsx", SpreadsheetDocumentType.Workbook)]
[TestCase("xlsm", SpreadsheetDocumentType.MacroEnabledWorkbook)]
[TestCase("xltx", SpreadsheetDocumentType.Template)]
[TestCase("xltm", SpreadsheetDocumentType.MacroEnabledTemplate)]
public void SavesAsProperSpreadsheetDocumentType(string extension, SpreadsheetDocumentType expectedType)
{
using (var tf = new TemporaryFile(Path.ChangeExtension(Path.GetTempFileName(), extension)))
{
using (var wb = new XLWorkbook())
{
wb.Worksheets.Add("Sheet1");
wb.SaveAs(tf.Path);
}
using (var package = SpreadsheetDocument.Open(tf.Path, false))
{
Assert.AreEqual(expectedType, package.DocumentType);
}
}
}
[Test]
public void CanSaveTemplateAsWorkbook()
{
// See #1375
using (var template = new TemporaryFile(Path.ChangeExtension(Path.GetTempFileName(), "xltx")))
using (var workbook = new TemporaryFile())
{
using (var wb = new XLWorkbook())
{
wb.AddWorksheet();
wb.SaveAs(template.Path);
}
using (var wb = new XLWorkbook(template.Path))
{
wb.SaveAs(workbook.Path);
}
using (var package = SpreadsheetDocument.Open(workbook.Path, false))
{
Assert.AreEqual(SpreadsheetDocumentType.Workbook, package.DocumentType);
}
}
}
[Test]
public void SaveAsWithNoExtensionFails()
{
using (var tf = new TemporaryFile("FileWithNoExtension"))
using (var wb = new XLWorkbook())
{
wb.Worksheets.Add("Sheet1");
TestDelegate action = () => wb.SaveAs(tf.Path);
Assert.Throws<ArgumentException>(action);
}
}
[Test]
public void SaveAsWithUnsupportedExtensionFails()
{
using (var tf = new TemporaryFile("FileWithBadExtension.bad"))
using (var wb = new XLWorkbook())
{
wb.Worksheets.Add("Sheet1");
TestDelegate action = () => wb.SaveAs(tf.Path);
Assert.Throws<ArgumentException>(action);
}
}
[Test]
public void SaveCellValueWithLeadingQuotationMarkCorrectly()
{
var quotedFormulaValue = "'=IF(TRUE, 1, 0)";
using (var ms = new MemoryStream())
{
using (var wb = new XLWorkbook())
{
var ws = wb.AddWorksheet("Sheet1");
var cell = ws.FirstCell();
cell.SetValue(quotedFormulaValue);
Assert.IsFalse(cell.HasFormula);
Assert.AreEqual(quotedFormulaValue, cell.Value);
wb.SaveAs(ms);
}
ms.Seek(0, SeekOrigin.Begin);
using (var wb = new XLWorkbook(ms))
{
var ws = wb.Worksheets.First();
var cell = ws.FirstCell();
Assert.IsFalse(cell.HasFormula);
Assert.AreEqual(quotedFormulaValue, cell.Value);
}
}
}
[Test]
public void PreserveHeightOfEmptyRowsOnSaving()
{
using (var ms = new MemoryStream())
{
using (var wb = new XLWorkbook())
{
var ws = wb.AddWorksheet("Sheet1");
ws.RowHeight = 50;
ws.Row(2).Height = 0;
ws.Row(3).Height = 20;
ws.Row(4).Height = 100;
ws.CopyTo("Sheet2");
wb.SaveAs(ms);
}
ms.Seek(0, SeekOrigin.Begin);
using (var wb = new XLWorkbook(ms))
{
foreach (var sheetName in new[] { "Sheet1", "Sheet2" })
{
var ws = wb.Worksheet(sheetName);
Assert.AreEqual(50, ws.Row(1).Height);
Assert.AreEqual(0, ws.Row(2).Height);
Assert.AreEqual(20, ws.Row(3).Height);
Assert.AreEqual(100, ws.Row(4).Height);
}
}
}
}
[Test]
public void PreserveWidthOfEmptyColumnsOnSaving()
{
using (var ms = new MemoryStream())
{
using (var wb = new XLWorkbook())
{
var ws = wb.AddWorksheet("Sheet1");
ws.Column(2).Width = 0;
ws.Column(3).Width = 20;
ws.Column(4).Width = 100;
ws.CopyTo("Sheet2");
wb.SaveAs(ms);
}
ms.Seek(0, SeekOrigin.Begin);
using (var wb = new XLWorkbook(ms))
{
foreach (var sheetName in new[] { "Sheet1", "Sheet2" })
{
var ws = wb.Worksheet(sheetName);
Assert.AreEqual(ws.ColumnWidth, ws.Column(1).Width);
Assert.AreEqual(0, ws.Column(2).Width);
Assert.AreEqual(20, ws.Column(3).Width);
Assert.AreEqual(100, ws.Column(4).Width);
}
}
}
}
[Test]
public void PreserveAlignmentOnSaving()
{
using (var input = TestHelper.GetStreamFromResource(TestHelper.GetResourcePath(@"TryToLoad\HorizontalAlignment.xlsx")))
using (var output = new MemoryStream())
{
using (var wb = new XLWorkbook(input))
{
wb.SaveAs(output);
}
using (var wb = new XLWorkbook(output))
{
Assert.AreEqual(XLAlignmentHorizontalValues.Center, wb.Worksheets.First().Cell("B1").Style.Alignment.Horizontal);
}
}
}
[Test]
public void PreserveMultipleColorScalesOnSaving()
{
using (var output = new MemoryStream())
{
using (var wb = new XLWorkbook())
{
var sheet = wb.Worksheets.Add("test");
sheet.Column(1).AddConditionalFormat().ColorScale().LowestValue(XLColor.Red)
.HighestValue(XLColor.Green);
sheet.Column(2).AddConditionalFormat().ColorScale().LowestValue(XLColor.Alizarin)
.HighestValue(XLColor.Blue);
wb.SaveAs(output);
}
using (var wb = new XLWorkbook(output))
{
var sheet = wb.Worksheets.First();
var cf = sheet.ConditionalFormats
.OrderBy(x => x.Range.RangeAddress.FirstAddress.ColumnNumber)
.ToArray();
Assert.AreEqual(2, cf.Length);
Assert.AreEqual(XLConditionalFormatType.ColorScale, cf[0].ConditionalFormatType);
Assert.AreEqual(XLColor.Red, cf[0].Colors[1]);
Assert.AreEqual(XLCFContentType.Minimum, cf[0].ContentTypes[1]);
Assert.AreEqual(XLColor.Green, cf[0].Colors[2]);
Assert.AreEqual(XLCFContentType.Maximum, cf[0].ContentTypes[2]);
Assert.AreEqual(XLConditionalFormatType.ColorScale, cf[1].ConditionalFormatType);
Assert.AreEqual(XLColor.Alizarin, cf[1].Colors[1]);
Assert.AreEqual(XLCFContentType.Minimum, cf[1].ContentTypes[1]);
Assert.AreEqual(XLColor.Blue, cf[1].Colors[2]);
Assert.AreEqual(XLCFContentType.Maximum, cf[1].ContentTypes[2]);
}
}
}
[Test]
public void RemoveExistingInlineStringsIfRequired()
{
using (var stream = TestHelper.GetStreamFromResource(TestHelper.GetResourcePath(@"Other\InlineStrings\inputfile.xlsx")))
using (var ms = new MemoryStream())
{
TestHelper.CreateAndCompare(() =>
{
var wb = new XLWorkbook(stream);
var ws = wb.Worksheet(1);
var numericCells = ws.CellsUsed(c => double.TryParse(c.GetString(), out double _));
var textCells = ws.CellsUsed(c => !double.TryParse(c.GetString(), out double _));
foreach (var cell in numericCells)
{
cell.Clear(XLClearOptions.AllFormats);
cell.SetDataType(XLDataType.Number);
}
foreach (var cell in textCells)
{
cell.ShareString = true;
}
wb.SaveAs(ms);
return wb;
}, @"Other\InlineStrings\outputfile.xlsx");
}
}
[Test]
public void CanSaveFileWithEmptyFill()
{
using (var stream = TestHelper.GetStreamFromResource(TestHelper.GetResourcePath(@"TryToLoad\EmptyFill.xlsx")))
using (var wb = new XLWorkbook(stream))
using (var ms = new MemoryStream())
{
Assert.DoesNotThrow(() => wb.SaveAs(ms, false));
}
}
[Test]
public void CanSaveSingleRowAutoFilter()
{
using (var stream = TestHelper.GetStreamFromResource(TestHelper.GetResourcePath(@"TryToLoad\SingleRowAutoFilter.xlsx")))
using (var wb = new XLWorkbook(stream))
using (var ms = new MemoryStream())
{
Assert.DoesNotThrow(() => wb.SaveAs(ms, false));
}
}
[Test]
public void PivotTableWithVeryLongField()
{
TestHelper.CreateAndCompare(() =>
{
var wb = new XLWorkbook();
var ws = wb.AddWorksheet();
var longText = string.Join(" ", Enumerable.Range(0, 40).Select(i => "1234567890"));
var data = new[]
{
new { Col1 = longText, Col2 = 2}
};
var table = ws.FirstCell().InsertTable(data);
var pvtSheet = wb.AddWorksheet("pvt");
var pvt = table.CreatePivotTable(pvtSheet.FirstCell(), "PivotTable1");
pvt.RowLabels.Add("Col1");
return wb;
}, @"Other\PivotTableReferenceFiles\LongText\outputfile.xlsx");
}
[Test]
public void CanSaveFileWithVml_NoComments()
{
//See #1285
using (var stream = TestHelper.GetStreamFromResource(TestHelper.GetResourcePath(@"TryToLoad\FileWithButton.xlsm")))
using (var wb = new XLWorkbook(stream))
using (var ms = new MemoryStream())
{
Assert.DoesNotThrow(() => wb.SaveAs(ms));
}
}
[Test]
public void CanEnableWorkbookFilterPrivacyAndSaveInWorkbook()
{
using var ms = new MemoryStream();
using (var wb = new XLWorkbook())
{
wb.AddWorksheet();
wb.SaveAs(ms, new SaveOptions { FilterPrivacy = true });
}
ms.Seek(0, SeekOrigin.Begin);
using (var wb = SpreadsheetDocument.Open(ms, false))
{
Assert.IsTrue(wb.WorkbookPart.Workbook.WorkbookProperties.FilterPrivacy);
}
}
[Test]
public void WorkbookFilterPrivacyIsNotSetByDefault()
{
using var ms = new MemoryStream();
using (var wb = new XLWorkbook())
{
wb.AddWorksheet();
wb.SaveAs(ms);
}
ms.Seek(0, SeekOrigin.Begin);
using (var wb = SpreadsheetDocument.Open(ms, false))
{
Assert.IsNull(wb.WorkbookPart.Workbook.WorkbookProperties.FilterPrivacy);
}
}
[Test]
public void WorkbookFilterPrivacyIsReadCorrectly()
{
using (var stream = TestHelper.GetStreamFromResource(TestHelper.GetResourcePath(@"TryToLoad\FilterPrivacyEnabledWorkbook.xlsx")))
using (var wb = SpreadsheetDocument.Open(stream, false))
{
Assert.IsTrue(wb.WorkbookPart.Workbook.WorkbookProperties.FilterPrivacy);
}
}
[Test]
public void CanSaveAsWithDataValidationAfterInsertFirstRowsAboveAndInsertFirstColumnsBefore()
{
using (var wb = new XLWorkbook())
using (var ms = new MemoryStream())
{
var ws = wb.AddWorksheet("WithDataValidation");
ws.Range("B4:B4").SetDataValidation().WholeNumber.Between(0, 1);
ws.Row(1).InsertRowsAbove(1);
var dv = ws.DataValidations.ToArray();
Assert.AreEqual(1, dv.Length);
Assert.AreEqual("B5:B5", dv[0].Ranges.Single().RangeAddress.ToString());
Assert.DoesNotThrow(() => wb.SaveAs(ms));
ws.Column(1).InsertColumnsBefore(1);
dv = ws.DataValidations.ToArray();
Assert.AreEqual(1, dv.Length);
Assert.AreEqual("C5:C5", dv[0].Ranges.Single().RangeAddress.ToString());
Assert.DoesNotThrow(() => wb.SaveAs(ms));
}
}
}
}