3.5.2

Braking changes

Added features

Fixed bugs

• #416, #425: Fixed documentation for passed stream argument in read operations

3.5.1

Braking changes

Added features

Fixed bugs

#413, #412 Fixed creation of Culture in .Net 6

3.5.0

Braking changes

Added features

#363 Provide a setting to control how fixed-length fields are truncated

Fixed bugs

#389 Fixed typo in error message
#256, #263, #391 Fixed events when reading / writing with MultiRecordEngine

Other

#263 Hint, that INotifyRead and INotifyWrite need a EventEngineBase to work
#365 Typo in SameFieldOrder

Technical

#387 FSharp tests are in main test assembly included
#383, #384 Upgrade projects to SDK style
#385 Examples are in build again

3.4.2

Braking changes

Added features

Fixed bugs

#337 Update Package Information
#365 Typo in SameFieldOrder
#369 Fixes in exception messages
#271 Memory leak in FileHelpers
#343 Allowing other to write to file

3.4.1

Braking Changes

Added Features

Fixed bugs

• #291, #354 Excel NPOI Missing values are written as blank cells

3.4.0

Braking Changes

• Removed support for Excel via COM Interop FileHelpers.ExcelStorage. We will not publish any new version of this package. Please use FileHelpers.ExcelNPOIStorage instead.

Added Features

• #331 Handle auto-properties used in F# correctly
  • Please notice that currently auto-properties in VB.Net are not supported (#201)
• #315, #316 Added support for setting NewLine string for files produced by FileHelperAsyncEngine, MultiRecordEngine and MasterDetailEngine.
• #308, #86 Added Recordtype to ErrorInfo
• #306 Customizable CultureInfo at field and record level
• #273, #280 Removed Obsolete attribute on some methods in FileHelperEngine. Those attributes were introduced in release 3.2.7.

Fixed bugs

• #252, #332 Allow reading Excel files from stream

3.3.0

Breaking changes

• Removed nuget package for .NET Framework 3.5.
  In this release we have started to ship the main parts of the library for .NET Standard 2.0.
  Some reflection based uses now APIs that were not present with the .NET Framework 3.5.

Features

• Support for .NET Standard 2.0. That means that you can use FileHelpers from your .NET Core 2.0
  or UWP apps (#286, #295, #298, #300). Some parts of FileHelpers are not compiled to .NET Standard 2.0:
  • DataLink
  • Ability to generate a type at runtime: ClassBuilder and CsvClassBuilder
  • SmartFormatDetector
  • both FileHelpers.ExcelNPOIStorage and FileHelpers.ExcelStorage

Fixed bugs

• #268 Typo in error message

Technical

• #294 Using MsBuild 15 and Visual Studio 2017 to build project

3.2.7

Hi everyone again

After more than two years, we are proud to release FileHelpers 3.2.7!
Thanks to all the contributors and testers!

The packages are available on nuget.org.

We have invested lots of effort in the automatic creation and publishing of NuGet packages.
This should allow us to publish more often and with less effort in the future.

Thank you for your patience and for using FileHelpers,

Marcos Meli & Matthias Cavigelli

Breaking changes & deprecated features

• Removed nuget Package for .NET Framework 2.0.
  We are not building against .NET Framework 2.0 any longer.
  We would like to be able to use LINQ, which was not in .NET Framework 2.0.

Reduce API surface of the library and clean types

• Methods on FileHelperEngine that return a list
  • #102, #145, #153 (jboyer2012): instead use methods that return an array and then apply
    the extension method ToList() on it. Methods are marked as obsolete and workaround
    is described.
• Methods on FileHelperEngine that return a DataTable
  • #147 (jboyer2012): instead use the extension method ToDataTable. Methods are marked
    as obsolete and workaround is described.

Features

• #170 (Giuseppe Lipolis): Autoproperties full support!
  • It seems that this is not working yet with VB.Net Code (see #201 )
• #85, #156 (neildboson-au): Add FieldCaption attribute (neildobson-au)
  Adds the ability to create user-defined column names in generated files.
• (Jiri Formacek) Added ability to write enum as number in EnumConverter
• (Jiri Formacek) Expose new line delimiter when writing to file
• #226, #227 (consulting, Marcos Meli): expose CommandTimeout in DatabaseStorage
• #198 (Rob De Carteret): Auto assign block size in BigFileSorter

Analyzer

• #158 (raymegal): Analyzer to change IComparableRecord to IComparable.
• (Marcos Meli): Record type analyzer

Fixed bugs

• #217 (Marc Lopez): RecordInfo can remove multiple fields in an autoproperty class
• #186 (Marcos Meli): Fix of Enumerator usage in FileHelperAsyncEngine
• #157 (Marcos Meli): Removing last field from options does not reset the lastField property
• #178, #179, #180, #181, #182 (Stephen Moon): Documentation fixes

Internals

ExcelNPOI Storage

• #209 (juancfigueroa): Using XSSFWorkbook for files ending in "xlsm".
• Increased buffer size in FileHelperEngines when reading or writing

3.1.5

Yes after a some hard months of work here the final 3.1 release !!

Check out new redesigned Home Page www.filehelpers.net

With ton of examples, tips, and updated docs

This version is production ready and the recommended version

Install it from NuGet (recommended):

Install-Package FileHelpers

Or you can download the zip package with:

• The library for all versions of .net
• The Wizard
• Offline Help chm file

Analyzer

We recommend you to install the Roslyn Analyzer that helps you to use the library in the right way.

3.1.2

Hi everyone again !!

The FileHelpers has reached a big Milestone today we are releasing the 3.1 version! Now with full support for .NET 4.0, 4.5 and Mono and with a ton of news and enhancements. After some time off for different reasons we are now trying to update the library in a more regular fashion. We redesigned the HomeSite with a Material Design Template from GeeksLabs

Main changes

• NEW: Full .NET 2.0, 4.0 & 4.5 support.
• NEW: Added support for MONO !!
• NEW: FileHelpers.Analyzer is a Roslyn Analyzer with best practices and quicks fixes
• NEW: A ton of new examples, autogenerated from FileHelpers.Examples project
• NEW: Partial support to use Autoproperties
• NEW: Async Methods returns IDisposable to allow using() statements that autoclose files on ends or exception.
• NEW: Events for the Async engines.
• NEW: The events args now have TotalBytes and CurrentBytes to allow you show progress while reading or writing.
• NEW: FieldIndexers you can now get the values in the AsyncEngine like in the DataReader of ADO.NET =) You can access them via index or fieldName (at the moment case sensitive). This also completes the RunTime records support
• NEW: BigFileSorter: if you need to sort big files, you can use this feature that implements External Sorting
• NEW: SmartFormatDetector: A class designed to discover the format of delimited and flat files based on sample files. It is integrated with the wizzard
• NEW: FieldOrder: a new attribute to override the default order of fields.
• NEW: Better Delimited validations to make sure that the file contains the right number of fields
• NEW: [FieldValueDiscarted]: a new attribute to allow the value of a particular field to be read but not stored in the record class (this was a very requested feature)
• NEW: [FieldNotEmpty]: Indicates whether the target field needs to be populated with a non-empty value.
• MOD: The error messages have been made more meaningful. In all exceptions you get: FieldName, ColumnNumber, LineNumber etc.
• DOCS: rewritten thanks to the work of Ken Foskey and Matthias Cavigelli

Breaking Changes

• Removed support for .NET Compact Framework
• [FieldIgnored] => [FieldHidden]
• IComparableRecord => IComparable

Minor Changes

• Better caching of internal classes
• The core code of the library was refactored to make easier to extend it.
• Better performance.
• ADD: UpdateLinks properties, allow to specify how the library must handle Workbook links (thanks to Stefan Schälle)
• FIX: A little problem with the quoted fields in the wizard
• More documentation has been added to the Library source code. It is now even easier to get involved in development!