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
@@ -1,2 +1,53 @@
-# ClosedXML
+![ClosedXML](https://github.com/ClosedXML/ClosedXML/blob/develop/resources/logo/readme.png)

+[![Release](https://img.shields.io/badge/release-0.95.4-blue.svg)](https://github.com/ClosedXML/ClosedXML/releases/latest) [![NuGet Badge](https://buildstats.info/nuget/ClosedXML)](https://www.nuget.org/packages/ClosedXML/) [![.NET Framework](https://img.shields.io/badge/.NET%20Framework-%3E%3D%204.0-red.svg)](#) [![.NET Standard](https://img.shields.io/badge/.NET%20Standard-%3E%3D%202.0-red.svg)](#) [![Build status](https://ci.appveyor.com/api/projects/status/wobbmnlbukxejjgb?svg=true)](https://ci.appveyor.com/project/ClosedXML/ClosedXML/branch/develop/artifacts)
+[![Open Source Helpers](https://www.codetriage.com/closedxml/closedxml/badges/users.svg)](https://www.codetriage.com/closedxml/closedxml)
+
+[💾 Download unstable CI build](https://ci.appveyor.com/project/ClosedXML/ClosedXML/branch/develop/artifacts)
+
+ClosedXML is a .NET library for reading, manipulating and writing Excel 2007+ (.xlsx, .xlsm) files. It aims to provide an intuitive and user-friendly interface to dealing with the underlying [OpenXML](https://github.com/OfficeDev/Open-XML-SDK) API.
+
+[For more information see the wiki](https://github.com/closedxml/closedxml/wiki)
+
+### Install ClosedXML via NuGet
+
+If you want to include ClosedXML in your project, you can [install it directly from NuGet](https://www.nuget.org/packages/ClosedXML)
+
+To install ClosedXML, run the following command in the Package Manager Console
+
+```
+PM> Install-Package ClosedXML
+```
+
+### What can you do with this?
+
+ClosedXML allows you to create Excel files without the Excel application. The typical example is creating Excel reports on a web server.
+
+**Example:**
+```c#
+using (var workbook = new XLWorkbook())
+{
+    var worksheet = workbook.Worksheets.Add("Sample Sheet");
+    worksheet.Cell("A1").Value = "Hello World!";
+    worksheet.Cell("A2").FormulaA1 = "=MID(A1, 7, 5)";
+    workbook.SaveAs("HelloWorld.xlsx");
+}
+```
+
+### Extensions
+Be sure to check out our `ClosedXML` extension projects
+- https://github.com/ClosedXML/ClosedXML.Report
+- https://github.com/ClosedXML/ClosedXML.Extensions.AspNet
+- https://github.com/ClosedXML/ClosedXML.Extensions.Mvc
+- https://github.com/ClosedXML/ClosedXML.Extensions.WebApi
+
+## Developer guidelines
+The [OpenXML specification](https://www.ecma-international.org/publications/standards/Ecma-376.htm) is a large and complicated beast. In order for ClosedXML, the wrapper around OpenXML, to support all the features, we rely on community contributions. Before opening an issue to request a new feature, we'd like to urge you to try to implement it yourself and log a pull request.
+
+Please read the [full developer guidelines](CONTRIBUTING.md).
+
+## Credits
+* Project originally created by Manuel de Leon
+* Current maintainer: [Francois Botha](https://github.com/igitur)
+* Master of Computing Patterns: [Aleksei Pankratev](https://github.com/Pankraty)
+* Logo design by [@Tobaloidee](https://github.com/Tobaloidee)