Update v3.0.0-rc.3

rabanti-github · rabanti-github · commit 7d825931307d · 2025-12-02T23:35:33.000+01:00
diff --git a/Changelog.md b/Changelog.md
@@ -1,43 +1,108 @@
 # Change Log
 
-## v2.6.3 
+## v3.0.0-rc.3
 
 ---
-Release Date: **XX.YY.2025**
+Release Date: **02.12.2025**
 
+- Formal changes to enforce displaying target frameworks in NuGet meta package
+
+Note: The version numbers of the dependencies `NanoXLSX.Core`, `NanoXLSX.Reader` and `NanoXLSX.Writer` have not changed with this release. There are also no functional changes
+
+
+
+## v3.0.0-rc.2
+
+---
+Release Date: **27.11.2025**
+
+- Refactoring of several enums in `NanoXLSX.Core`, `NanoXLSX.Reader` and `NanoXLSX.Writer` from lowercase start to uppercase start for better consistency
+
+
+# v3.0.0-rc.1
+
+---
+Release Date: **25.11.2025**
+
+- Initial release candidate of the NanoXLSX library split into three separate libraries:
+  - NanoXLSX.Core
+  - NanoXLSX.Reader
+  - NanoXLSX.Writer
+
+## v2.6.7
+
+---
+Release Date: **01.10.2025**
+
+- Fixed handling of worksheet protection (regression bug)
+- Code cleanup
+
+## v2.6.6
+
+---
+Release Date: **29.09.2025**
+
+- Fixed handling of worksheet protection (selecting locked or unlocked cells)
+- Added test case
+
+Note: The default value of `Style.CurrentCellXf.Locked` is now true, to be consistent with Excel behavior. This change only affects worksheets with protection enabled and may require
+  explicit unlocking of cells that should remain editable
+
+## v2.6.5
+
+---
+Release Date: **13.09.2025**
+
+- Added import option to ignore invalid column widths or row heights. Concept provided by pokorny
+- Added test case
+
+## v2.6.4
+
+---
+Release Date: **19.07.2025**
+
+- Added support for in-line string values (non-formatted). Change provided by Misir
+- Added test case
+
+## v2.6.3
+
+---
+Release Date: **26.04.2025**
+
+- Fixed a bug that prevented adding new worksheets when a pane split was defined
 - Changed handling of reading workbooks, when docProps are missing (formal change)
 - Added test case
 
-## v2.6.2 
+## v2.6.2
 
 ---
 Release Date: **24.01.2025**
 
 - Fixed a regression bug in the Cell function ConvertArray
 - Added test cases
 
-## v2.6.1 
+## v2.6.1
 
 ---
 Release Date: **19.01.2025**
 
 - Fixed a bug on writing default column styles (not persisted in some cases)
-- Adapted style reader: When a workbook is loaded, not defined color values of Border styles are now empty strings (were null), as if a new style is created 
+- Adapted style reader: When a workbook is loaded, not defined color values of Border styles are now empty strings (were null), as if a new style is created
 - Code maintenance
 
 Note: The color values of Border styles are handled identical on writing XLSX files, either if null or empty. The change of the reader behavior was to enforce the "What You Can Write Is What You Can Read" policy of the library (writing an empty string as color value should lead to an empty string on read).
 
-## v2.6.0 
+## v2.6.0
 
 ---
 Release Date: **12.01.2025**
 
 - Added InsertRow and InsertColumn functions. Functionality provided by Alexander Schlecht
-- Added FirstCewllByValue, FirstOrDefaultCell, CellsByValue functions. Functionality provided by Alexander Schlecht
+- Added FirstCellByValue, FirstOrDefaultCell, CellsByValue functions. Functionality provided by Alexander Schlecht
 - Added ReplaceCellValue function. Functionality provided by Alexander Schlecht
 - Code maintenance
 
-## v2.5.2 
+## v2.5.2
 
 ---
 Release Date: **24.11.2024**
@@ -48,13 +113,17 @@ Release Date: **24.11.2024**
 - Added tests for column address resolution
 
 ## v2.5.1
+
 ---
 Release Date: **26.10.2024**
+
 - Fixed a bug regarding the determination of the first data cell in an empty worksheet. Bug fix provided by Martin Stránský
 
 ## v2.5.0
+
 ---
 Release Date: **22.07.2024**
+
 - Adapted handling of the font scheme in styles. The scheme is now determined automatically
 - Added column option to define a default column style
 - Added tests
@@ -66,7 +135,7 @@ Release Date: **21.04.2024**
 
 - Added handling to load workbooks from files asynchronously. Concept provided by John Leyva
 - Fixed a bug when loading a workbook asynchronously from a stream. Bug fix provided by John Leyva
-- Fixed a bug when the column auto-filter is a single cell address. Bug fix provided by Lukáš Pokorný
+- Fixed a bug when the column auto-filter is a single cell address. Bug fix provided by pokorny
 - Fixed a bug regarding style enumeration when reading a workbook. Bug fix provided by Martin Stránský
 - Added new  and adapted existing test cases
 
@@ -83,7 +152,7 @@ Release Date: **24.02.2024**
 ---
 Release Date: **24.02.2024**
 
-- Fixed a bug when reading min and max values in the GetLastDataColumnNumber function. Bug fix provided by Lukáš Pokorný
+- Fixed a bug when reading min and max values in the GetLastDataColumnNumber function. Bug fix provided by pokorny
 - Code maintenance
 
 ## v2.3.1
@@ -172,7 +241,7 @@ Release Date: **29.09.2022**
 
 Note:
 
-- When defining a custom number format, now the CustomFormatCode property must always be defined as well, since an empty value leads to an invalid Workbook
+- When defining a custom number format, now the CustomFormatCode property must always be defined as well, since an empty value leads to an invalid Workbook 
 - When a cell is now created (by constructor) with the type EMPTY, any passed value will be discarded in this cell
 
 ## v2.0.1
@@ -250,7 +319,7 @@ Release Date: **03.09.2022 - Major Release**
 - Added global casting import options: AllNumbersToDouble, AllNumbersToDecimal, AllNumbersToInt, EverythingToString
 - Added column casting import options: Double, Decimal
 - Added global import options: EnforcePhoneticCharacterImport, EnforceEmptyValuesAsString, DateTimeFormat, TemporalCultureInfo
-- Added a metadata reader for workbook metadata
+- Added a meta data reader for workbook meta data
 - All style elements that can be written can also be read
 - All workbook elements that can be written can also be read (exception: passwords cannot be recovered)
 - All worksheet elements that can be written can also be read (exception: passwords cannot be recovered)
@@ -339,7 +408,7 @@ Release Date: **10.07.2021**
 - Fixed the internal representation of column widths and row heights
 - Minor code maintenance
 
-Note: The column widths and row heights may change slightly with this release, since now the actual (internal) width and height is applied when setting a non-standard column width or row height
+Note: The column widths and row heights may change slightly with this release, since the actual (internal) width and height is now applied when setting a non-standard column width or row height
 
 ## v1.7.0
 
@@ -433,6 +502,7 @@ Release Date: **01.12.2019**
 
 - Fixed a bug of reorganized worksheets (when deleted in Excel)
 - Fixed a bug in the handling of shared strings
+- Minor code maintenance
 
 ## v1.3.3
 
diff --git a/Docs.IndexGenerator/Config/meta-package-config.json b/Docs.IndexGenerator/Config/meta-package-config.json
@@ -1,5 +1,5 @@
 ﻿{
 "packageName": "NanoXLSX",
-"version": "3.0.0-rc.2",
+"version": "3.0.0-rc.3",
 "description": "NanoXLSX is a library to generate and read Microsoft Excel files (XLSX) in an easy and native way. This package is the meta package of NanoXLSX and should be used in most cases as dependency in your project."
 }
diff --git a/MigrationGuide.md b/MigrationGuide.md
@@ -369,10 +369,13 @@ ApplicationDefined, ANSI, Default, Symbols, Mac, ShiftJIS, Hangul, Johab, GBK, B
 ---
 
 ### Theme
+
 The `Theme` class was introduced with NanoXLSX v3.0.0 It represents the theme of a workbook, which contains several color schemes and font schemes.
 The class can mostly be ignored unless specific stylings are required.
 Theme may be references ind Styles, especially in Fonts.
+
 - The enum `Theme.ColorSchemeElement` was introduced to represent the color scheme elements of a theme. The available values are:
+
 ```cs
  dark1, light1, dark2, light2, accent1, accent2, accent3, accent4, accent5, accent6, hyperlink, followedHyperlink
 ```
diff --git a/NanoXLSX.Core/Changelog.md b/NanoXLSX.Core/Changelog.md
@@ -1,15 +1,15 @@
 # Change Log - NanoXLSX.Core
 
-## v3.0.0-rc.1
+## v3.0.0-rc.2
 
 ---
-Release Date: **25.11.2025**
+Release Date: **27.11.2025**
 
-- Initial release of the core library
+- Refactoring of several enums from lowercase start to uppercase start for better consistency
 
-## v3.0.0-rc.2
+## v3.0.0-rc.1
 
 ---
-Release Date: **27.11.2025**
+Release Date: **25.11.2025**
 
-- Refactoring of several enums from lowercase start to uppercase start for better consistency
+- Initial release of the core library
diff --git a/NanoXLSX.Reader/Changelog.md b/NanoXLSX.Reader/Changelog.md
@@ -1,15 +1,15 @@
 # Change Log - NanoXLSX.Reader
 
-## v3.0.0-rc.1
+## v3.0.0-rc.2
 
 ---
-Release Date: **25.11.2025**
+Release Date: **27.11.2025**
 
-- Initial release of the reader library
+- Refactoring of several enums from lowercase start to uppercase start for better consistency
 
-## v3.0.0-rc.2
+## v3.0.0-rc.1
 
 ---
-Release Date: **27.11.2025**
+Release Date: **25.11.2025**
 
-- Refactoring of several enums from lowercase start to uppercase start for better consistency
+- Initial release of the reader library
diff --git a/NanoXLSX.Writer/Changelog.md b/NanoXLSX.Writer/Changelog.md
@@ -1,15 +1,15 @@
 # Change Log - NanoXLSX.Writer
 
-## v3.0.0-rc.1
+## v3.0.0-rc.2
 
 ---
-Release Date: **25.11.2025**
+Release Date: **27.11.2025**
 
-- Initial release of the writer library
+- Refactoring of several enums from lowercase start to uppercase start for better consistency
 
-## v3.0.0-rc.2
+## v3.0.0-rc.1
 
 ---
-Release Date: **27.11.2025**
+Release Date: **25.11.2025**
 
-- Refactoring of several enums from lowercase start to uppercase start for better consistency
+- Initial release of the writer library
diff --git a/NanoXLSX/NanoXLSX.csproj b/NanoXLSX/NanoXLSX.csproj
@@ -8,7 +8,7 @@
 
     <!-- NuGet metadata -->
     <PackageId>NanoXLSX</PackageId>
-    <Version>3.0.0-rc.2</Version>
+    <Version>3.0.0-rc.3</Version>
     <Authors>Raphael Stoeckli</Authors>
     <Description>NanoXLSX is a library to generate and read Microsoft Excel files (XLSX) in an easy and native way. This package is the meta package of NanoXLSX and should be used in most cases as dependency in your project.</Description>
     <PackageRequireLicenseAcceptance>false</PackageRequireLicenseAcceptance>
@@ -26,7 +26,7 @@
     <PackageReleaseNotes>Please see https://github.com/rabanti-github/NanoXLSX/blob/master/Changelog.md for the release notes</PackageReleaseNotes>
     <AssemblyVersion>3.0.0.0</AssemblyVersion>
     <FileVersion>3.0.0.0</FileVersion>
-	<Version>3.0.0-rc.2</Version>
+	<Version>3.0.0-rc.3</Version>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>
     <IncludeSymbols>True</IncludeSymbols>
     <SymbolPackageFormat>snupkg</SymbolPackageFormat>
@@ -57,7 +57,23 @@
   <PropertyGroup>
     <DocsProjectName>$(PackageId)</DocsProjectName>
     <DocsVersion>$(Version)</DocsVersion>
-</PropertyGroup>
+	</PropertyGroup>
+
+	<ItemGroup>
+		<!-- Placeholder files for lib folders -->
+		<None Include="_._">
+			<Pack>true</Pack>
+			<PackagePath>lib/net45/</PackagePath>
+		</None>
+		<None Include="_._">
+			<Pack>true</Pack>
+			<PackagePath>lib/netstandard2.0/</PackagePath>
+		</None>
+
+		<!-- Your build props files -->
+		<None Include="build/net45/NanoXLSX.props" Pack="true" />
+		<None Include="build/netstandard2.0/NanoXLSX.props" Pack="true" />
+	</ItemGroup>
 	
 	
 	<Target Name="GenerateDocsIndex" AfterTargets="Build">
diff --git a/NanoXLSX/_._ b/NanoXLSX/_._
@@ -0,0 +1 @@
+﻿
diff --git a/README.md b/README.md
@@ -2,11 +2,20 @@
 
 # NanoXLSX
 
-
-![nuget](https://img.shields.io/nuget/v/NanoXLSX.svg?maxAge=86400)
-![license](https://img.shields.io/github/license/rabanti-github/NanoXlsx.svg)
+![NuGet Version](https://img.shields.io/nuget/v/NanoXLSX)
+![NuGet Downloads](https://img.shields.io/nuget/dt/NanoXLSX)
+![GitHub License](https://img.shields.io/github/license/rabanti-github/NanoXLSX)
 [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Frabanti-github%2FNanoXLSX.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2Frabanti-github%2FNanoXLSX?ref=badge_shield)
 
+## Pre-Release v3.x
+
+The pre-release of NanoXLSX is now available as [Nuget Package](https://www.nuget.org/packages/NanoXLSX/3.0.0-rc.2), version **3.0.0-rc.3**.
+Since there are breaking changes between NanoXLSX v2.x and v3.0.0-rc3, please see the **[Migration guide](MigrationGuide.md)**, to migrate applications from v2 to v3. Please feel free to open issues, in case of problems with the pre-release.
+
+There will be possibly further adaptions and additional pre-releases before the final release.
+
+---
+
 NanoXLSX is a small .NET library written in C#, to create and read Microsoft Excel files in the XLSX format (Microsoft Excel 2007 or newer) in an easy and native way
 
 * **Minimum of dependencies** (\*
@@ -34,7 +43,7 @@ The biggest change is the full capable reader support for workbook, worksheet an
 Version 2.x of NanoXLSX was completely overhauled and a high number of (partially parametrized) unit tests with a code coverage of >99% were written to improve the quality of the library.
 However, it is not planned as a LTS version. The upcoming v3.x is supposed to introduce some important functions, like in-line cell formatting, better formula handling and additional worksheet features.
 Furthermore, it is planned to introduce more modern OOXML features like the SHA256 implementation of worksheet passwords.
-One of the main aspects of this upcoming version is a better modularization, as well as the consolidation with PicoXLS to one single code base.
+One of the main aspects of this upcoming version is a better modularization, as well as the consolidation with PicoXLSX to one single code base.
 
 ## Reader Support
 
@@ -46,6 +55,7 @@ There are some limitations:
 * There are some approximations for floating point numbers. These values (e.g. pane split widths) may deviate from the originally written values
 * Numeric values are cast to the appropriate .NET types with best effort. There are import options available to enforce specific types
 * No support of other objects than spreadsheet data at the moment
+* Due to the potential high complexity, custom number format codes are currently not automatically escaped on writing or un-escaped on reading
 
 ## Requirements
 
@@ -69,6 +79,10 @@ If you want to compile the documentation project (folder: Documentation; project
 
 The .NET version of the documentation may vary, based on the installation. If v4.5 is not available, upgrade to target to a newer version, like v4.6
 
+### Utility dependencies
+
+The Test project and GitHub Actions may also require dependencies like unit testing frameworks or workflow steps. However, **none of these dependencies are essential to build the library**. They are just utilities. The test dependencies ensure efficient unit testing and code coverage. The GitHub Actions dependencies are used for the automatization of releases and API documentation
+
 ## Installation
 
 ### Using NuGet
@@ -140,7 +154,6 @@ See also: [Getting started in the Wiki](https://github.com/rabanti-github/NanoXL
 
 Hint: You will find most certainly any function, and the way how to use it, in the [Unit Test Project](https://github.com/rabanti-github/NanoXLSX/tree/master/NanoXlsx%20Test)
 
-
-
 ## License
+
 [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Frabanti-github%2FNanoXLSX.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Frabanti-github%2FNanoXLSX?ref=badge_large)

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"packageName": "NanoXLSX",`
`3`		`-"version": "3.0.0-rc.2",`
	`3`	`+"version": "3.0.0-rc.3",`
`4`	`4`	`"description": "NanoXLSX is a library to generate and read Microsoft Excel files (XLSX) in an easy and native way. This package is the meta package of NanoXLSX and should be used in most cases as dependency in your project."`
`5`	`5`	`}`