All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
- Added nullability attributes (#840, #849)
- Added overload for
OpenXmlPartReader
andOpenXmlReader.Create(...)
to ignore whitespace (#857) - Added
HexBinaryValue.TryGetBytes(...)
andHexBinaryValue.Create(byte[])
to manage the encoding and decoding of bytes (#867) - Implemented
IEquatable<IdPartPair>
onIdPartPair
to fix equality implementation there and obsoleted setters (#871) - Added generated classes for Office 2019 types and constraints (#882)
- Fixed serialization of
CellValue
constructors to use invariant cultures (#903) - Fixed parsing to allow exponents for numeric cell values (#901)
- Fixed issue where
CellValue
may validate incorrectly for boolean values (#890)
- Fixed issue where
OpenSettings.RelationshipErrorHandlerFactory
creates invalid XML if the resulting URI is smaller than the input (#883)
- Fixed bug where properties on
OpenXmlCompositeElement
instances could not be set to null to remove element (#850) - Fixed
OpenXmlElement.RawOuterXml
to properly set null values without throwing (#818) - Allow rewriting of all malformed URIs regardless of target value (#835)
- Added
OpenSettings.RelationshipErrorHandlerFactory
to provide a way to handle URIs that break parsing documents with malformed links (#793) - Added
OpenXmlCompositeElement.AddChild(OpenXmlElement)
to add children in the correct order per schema (#774) - Added
SmartTagClean
andSmartTagId
in place ofSmtClean
andSmtId
(#747) - Added
OpenXmlValidator.Validate(..., CancellationToken)
overrides to allow easier cancellation of long running validation on .NET 4.0+ (#773) - Added overloads for
CellValue
to takedecimal
,double
, andint
, as well as convenience methods to parse them (#782) - Added validation for
CellType
for numbers and date formats (#782) - Added
OpenXmlReader.GetLineInfo()
to retrieveIXmlLineInfo
of the underlying reader if available (#804)
- Fixed exception that would be thrown if attempting to save a document as FlatOPC if it contains SVG files (#822)
- Added
SchemaAttrAttribute
attributes back for backwards compatibility (#825)
- Removed explicit reference to
System.IO.Packaging
on .NET 4.6 builds (#774)
- Fixed massive performance bottleneck when
IndexReferenceConstraint
andReferenceExistConstraint
are involved (#763) - Fixed
CellValue
to only include three most signficant digits on second fractions to correct issue loading dates (#741) - Fixed a couple of validation indexing errors that might cause erroneous validation errors (#767)
- Updated internal validation system to not use recursion, allowing for better short-circuiting (#766)
- Fixed broken source link (#749)
- Ensured compilation is deterministic (#749)
- Removed extra file in NuGet package (#749)
- Ensure .NET Framework builds pass PEVerify (#744)
OpenXmlPartContainer.DeletePart
no longer throws an exception if there isn't a match for the identifier given (#740)- Mark obsolete members to not show up with Intellisense (#745)
- Fixed issue with
AttributeRequiredConditionToValue
semantic constraint where validation could fail on correct input (#746)
- Added
FileFormatVersions.2019
enum (#695) - Added
ChartSpace
and chart elements for the new 2016 namespaces. This allows the connecting pieces for building a chart part with chart styles like "Sunburst" (#687). - Added
OpenXmlElementFunctionalExtensions.With(...)
extension methods, which offer flexible means for constructingOpenXmlElement
instances in the context of pure functional transformations (#679) - Added minimum Office versions for enum types and values (#707)
- Added additional
CompatSettingNameValues
values:UseWord2013TrackBottomHyphenation
,AllowHyphenationAtTrackBottom
, andAllowTextAfterFloatingTableBreak
(#706) - Added gfxdata attribue to Arc, Curve, Line, PolyLine, Group, Image, Oval, Rect, and RoundRect shape complex types per MS-OI29500 2.1.1783-1799 (#709)
- Added
OpenXmlPartContainer.TryGetPartById
to enable child part retrieval without exception if it does not exist (#714) - Added
OpenXmlPackage.StrictRelationshipFound
property that indicates whether this package contains Transitional relationships converted from Strict (#716)
- Custom derived parts did not inherit known parts from its parent, causing failure when adding parts (#722)
- Marked the property setters in
OpenXmlAttribute
as obsolete as structs should not have mutable state (#698)
- Ensured attributes are available when
OpenXmlElement
is initialized with outer XML (#684, #692) - Some documentation errors (#681)
- Removed state that made it non-thread safe to validate elements under certain conditions (#686)
- Correctly inserts strongly-typed elements before known elements that are not strongly-typed (#690)
- Added initial Office 2016 support, including
FileFormatVersion.Office2016
,ExtendedChartPart
and other new schema elements (#586) - Added .NET Standard 2.0 target (#587)
- Included symbols support for debugging (#650)
- Exposed
IXmlNamespaceResolver
fromXmlPath
instead of formatted list of strings to expose namespace/prefix mapping (#536) - Implemented
IComparable<T>
andIEquatable<T>
onOpenXmlComparableSimpleValue
to allow comparisons without boxing (#550) - Added
OpenXmlPackage.RootPart
to easily access the root part on any package (#661)
- Updated to v4.7.0 of System.IO.Packaging which brings in a number of perf fixes (#660)
- Consolidated data for element children/properties to reduce duplication (#540, #547, #548)
- Replaced opaque binary data for element children constraints with declarative model (#603)
- A number of performance fixes to minimize allocations where possible
- 20% size reduction from 5.5mb to 4.3mb
- The validation subsystem went through a drastic redesign. This may cause changes in what errors are reported.
- Fixed some documentation inconsistencies (#582)
- Fixed
ToFlatOpcDocument
,ToFlatOpcString
,FromFlatOpcDocument
, andFromFlatOpcString
to correctly process Alternative Format Import Parts, or "altChunk parts" (#659)
- Added a workaround for a .NET Native compiler issue that doesn't support calling Marshal.SizeOf with a struct that contains auto-implemented properties (#569)
- Fixed a documentation error (#528)
ListValue
now implementsIEnumerable<T>
(#385)- Added a
WebExtension.Frozen
and obsoleted misspelledFronzen
property (#460) - Added an
OpenXmlPackage.CanSave
property that indicates whether a platform supports saving without closing the package (#468) - Simple types (except
EnumValue
andListValue
) now implementIComparable<T>
andIEquatable<T>
(#487)
- Removed state that was carried in validators that would hold onto packages when not in use (#390)
EnumSimpleType
parsing was improved and uses less allocations and caches for future use (#408)- Fixed a number of spelling mistakes in documentation (#462)
- When calling
OpenXmlPackage.Save
on .NET Framework, the package is now flushed to the stream (#468) - Fixed race condition while performing strict translation of attributes (#480)
- Schema data for validation uses a more compact format leading to a reduction in dll size and performance improvements for loading (#482, #483)
- A number of APIs are marked as obsolete as they have simple workarounds and will be removed in the next major change
- Fixed some constraint values for validation that contained Office 2007, even when it was only supported in later versions
- Updated
System.IO.Packaging
to 4.5.0 which fixes some issues on Xamarin platforms as well as minimizes dependencies on .NET Framework
- Corrected package license file reference to show updated MIT License
- Default runtime directive for better .NET Native support.
- Fixed part saving to be encoded with UTF8 but no byte order mark. This caused some renderers to not be able to open the generated document.
- Fixed exceptions thrown when errors are encountered while opening packages to be consistent across platforms.
- Fixed issue on Mono platforms using System.IO.Packaging NuGet package (Xamarin, etc) when creating a document.
- Fixed manual saving of a package when autosave is false.
- Fixed schema constraint data and standardized serialization across platforms.
- Upgraded to
System.IO.Packaging
version 4.4.0 which fixes some consistency with .NET Framework in opening packages.
- Package now supports .NET 3.5 and .NET 4.0 in addition to .NET Standard 1.3 and .NET Framework 4.6
- Fixed issue where assembly version wasn't set in assembly.
- Fixed crash when validation is invoked on .NET Framework with strong-naming enforced.
- SDK now supports .NET Standard 1.3
- Moved to using System.IO.Packaging from dotnet/corefx for .NET Standard 1.3 and WindowsBase for .NET 4.5.
- Cleaned up project build system to use .NET CLI.
- Added hundreds of XUnit tests. There are now a total of 1333 tests. They take about 20 minutes to run, so be patient.
- Incorporated a replacement
System.IO.Packaging
that fixes some serious (but exceptional) bugs found in the WindowsBase implementation