path: root/ThirdParty/CsvHelper-master/src/CsvHelper.Website/input/change-log/index.md

# Change Log

### 30.0.1

#### Bug Fixes

- Fixed issue when writing with the escape char not being escaped if it was different than the quote char.
- Fixed issue with `CsvWriter` not passing `leavOpen` parameter to other constructor call.
- Fixed issue with TypeConverter being assigned to a member that has a Convert expression assigned to it.

### 30.0.0

#### Features

- Added `Field` and `RawRecord` to `BadDataException`.
- Pass `IWriterConfiguration` into `CsvWriter` constructor instead of `CsvConfiguration`.
- Allow inherited header prefixes.
- Allow mapping to dynamic properties.
- Added `MemberName` to the type converter exception message.
- Added `MaxFieldSize` configuration. If max size is set and the size is reached, `MaxFieldSizeException` is thrown.
- Added class level attribute capability.  
  New Attributes:
  - `BufferSizeAttribute`
  - `CacheFieldsAttribute`
  - `CommentAttribute`
  - `CountBytesAttribute`
  - `DelimiterAttribute`
  - `DetectColumnCountChangesAttribute`
  - `DetectDelimiterAttribute`
  - `DetectDelimiterValueAttribute`
  - `EncodingAttribute`
  - `EscapeAttribute`
  - `ExceptionMessagesContainRawDataAttribute`
  - `HasHeaderRecordAttribute`
  - `IgnoreBlankLinesAttribute`
  - `IgnoreReferencesAttribute`
  - `IncludePrivateMembersAttribute`
  - `InjectionCharactersAttribute`
  - `InjectionEscapeCharacterAttribute`
  - `InjectionOptionsAttribute`
  - `LineBreakInQuotedFieldIsBadDataAttribute`
  - `MaxFieldSizeAttribute`
  - `ModeAttribute`
  - `NewLineAttribute`
  - `ProcessFieldAttribute`
  - `QuoteAttribute`
  - `TrimOptionsAttribute`
  - `UseNewObjectForNullReferenceMembersAttribute`
  - `WhiteSpaceCharsAttribute`
- Added `params object[] constructorArgs` to `TypeConverterAttribute`.
- Added validation message expression to `Validate` mapping.
- Added `IReaderRow` to `ValidateArgs`.
- Relax `Default` and `Constant` type constraints to `IsAssignableFrom`.

#### Bug Fixes

- Added `null` check in `WriteRecords`.
- Fixed interpolation in exception message.
- Fixed constructor mapping issue where parameter has a type converter but would still try and use constructor mapping. 

#### Breaking Changes

- Added `string field` and `string rawRecord` to `BadDataException` constructor.
- Added `double MaxFieldSize { get; }` to `IParserConfiguration`.
- Added `bool LeaveOpen { get; }` to `IWriterConfiguration`.
- Added `bool LeaveOpen { get; }` to `IParserConfiguration`.
- Added `IReaderRow row` to `ValidateArgs` constructor.

### 29.0.0

#### Features

- Added support for `TypeConverter` factories. This allows for the ability to handle many types at once.
Code that manually handle nullable, enums, and collections were changed into factories.
- Moved delimiter detection into a configuration function. 
This allows for a user to easily change the detection logic.
Default logic is in `ConfigurationFunction.GetDelimiter`.
- Changed `CsvConfiguration.SanitizeInjection` flag to `CsvConfiguration.InjectionOptions` enum.
  - Options are:
    - None - Default. Does no injection protection. The is default because it's not a part of CSV and is used for an external tool.
    - Escape - Escapes the field based on OWASP recommendations if an injection char is detected.
    - Strip - Removes the injection character.
    - Exception - Throws an exception if an injection char is detected.
  - Added `\t` and `\r` to `CsvConfiguration.InjectionEscapeCharacter`.
  - Changed `CsvConfiguration.InjectionEscapeCharacter` from `\t` to `'`.
- `CsvDataReader.GetDataTypeName` will use types when the schema table is overridden.
- More detail added to `CsvConfiguration.Validate` exception messages.
- Reduce double dictionary lookup in a few places.

#### Bug Fixes

- Fixed issues with delimiter detection logic.
- Missing `ConfigureAwait(false)` added to async calls.
- Fixed issue with `CsvReader.TryGetField` throwing an exception when multiple headers are read.
- Fixed issue with `MemberMap.Validate` passing the wrong type into the expression call.
- Fixed issue with `MemberMap<T>.Convert` not working with `static` methods.
- Fixed issue with `DateTimeConverter` and `DateTimeOffsetConverter` throwing an exception other than `TypeConverterException` on failure.
- Fixed issue where `MissingFieldFound` was not being called if `IgnoreBlankLines` was off.

#### Breaking Changes

- `CsvConfiguration.SanitizeForInjection` -> `CsvConfiguration.InjectionOptions`
- `bool IWriterConfiguration.SanitizeForInjection` -> `InjectionOptions IWriterConfiguration.InjectionOptions`
- `CsvConfiguration.InjectionEscapeCharacter` changed from `\t` to `'`.
- Added `\t` and `\r` to `CsvConfiguration.InjectionCharacters`.
- Added `GetDelimiter IParserConfiguration.GetDelimiter` delegate.

### 28.0.1

#### Bug Fixes

- Disabled nullable until all null issues are fixed.

### 28.0.0

#### Features

- Updated delimiter detection algorithm.
  - Strips escaped text based on mode.
  - Only looks for delimiters that appear on every line.
  - Uses `CultureInfo.TextInfo.ListSeparator` if it's on every line.
- Cache processed fields in parser so they're not processed on every access.
- Cache `CsvParser.Record[]` so multiple calls wont' regenerate it.
- `ShouldSkipRecord` is `null` by default and won't get called if not set.
- `ShouldSkipRecordArgs` holds `IReaderRow` now instead of `string[]`.
- Changed `CsvParser` constructor to take in `IParserConfiguration` instead of `CsvConfiguration`.
- Changed `CsvReader` constructor to take in `IReaderConfiguration` instead of `CsvConfiguration`.

#### Bug Fixes

- Fixed issue where collection types weren't getting the correct `MemberMapData` passed to them when converting the item.
- Fixed issue where `BadDataFound` was being called multiple times for the same field.
- Fixed issue where you can't read with no header when a name has been mapped.
- Fixed issue where quoted fields not correctly being identified if there was a buffer swap on white space before quote.

#### Breaking Changes

- `ShouldSkipRecordArgs` holds `IReaderRow` now instead of `string[]`.
- Removed `ConfigurationFunctions.ShouldSkipRecord` as the default is now `null`.
- Added `IParserConfiguration.Validate`.

### 27.2.1

#### Bug Fixes

- Changed dependencies to minimal needed version.

### 27.2.0

#### Features

- Support for net60 `DateOnly` and `TimeOnly` types.

### 27.1.1

#### Bug Fixes

- Fixed issue with delimiter detection in parser async read.

### 27.1.0

#### Features

- Added IgnoreBaseAttribute to not look at the base class when auto mapping.

### 27.0.4

#### Bug Fixes

- Changed delimiter detection to look line by line instead of the full buffer.

### 27.0.3

#### Bug Fixes

- Specified exact dependency version matches.

### 27.0.2

#### Bug Fixes

- Fixed issue with delimiter detection.

### 27.0.1

#### Bug Fixes

- `\t` wasn't removed and just an exception was being thrown.

### 27.0.0

#### Features

- Config option to auto detect delimiter. Off by default.
- Added ability to apply a type converter to all registered types.
- Added ability to apply type converter options to all registered types.
- Added ability to pass an IAsyncEnumerable to WriteRecords.
- Added option to use default value on conversion failure.

#### Breaking Changes

- Added `IParserConfiguration.DetectDelimiter`.
- Added `IParserConfiguration.DetectDelimiterValues`.
- Added `IWriter.WriteRecordsAsync<T>(IAsyncEnumerable<T> records, CancellationToken cancellationToken = default)`.
- Removed `\t` from `CsvConfiguration.WhiteSpaceChars` as a default.

### 26.1.0

#### Features

- Allow schema of destination table to be specified in CsvDataReader.

### 26.0.1

#### Bug Fixes

- Fixed issue with constant not working when the field is missing.

### 26.0.0

#### Features

- Added configuration for `ExceptionMessagesContainRawData` that defaults to true.

#### Bug Fixes

- Removed all `init` properties. These were causing people too many problems.
- Fixed issue with exception message not containing the header record.

#### Breaking Changes

- Added `bool IParserConfiguration.ExceptionMessagesContainRawData { get; }`.
- Added `bool IWriterConfiguration.ExceptionMessagesContainRawData { get; }`.
- All delegate args objects have `init` removed and now have constructors with parameters.
  - BadDataFound
  - ConvertFromString
  - GetConstructor
  - GetDynamicPropertyName
  - HeaderValidated
  - MissingFieldFound
  - PrepareHeaderForMatch
  - ReadingExceptionOccurred
  - ReferenceHeaderPrefix
  - ShouldQuote
  - ShouldSkipRecord
  - ShouldUseConstructorParameter
  - Validate

### 25.0.0

#### Bug Fixes

- Fixed stack overflow issue with accessing Parser[int] or Parser.Record in BaddataFound callback. Throws an exception explaining issue now.

#### Breaking Changes

- All delegate args had their non-parameterless constructor removed in favor of using `init`.

### 24.0.1

#### Bug Fixes

- Fixed issue with Trimming all white space.

### 24.0.0

#### Features

- Added `CancellationToken` to reading and writing async methods.

#### Bug Fixes

- Fixed issue with `ShouldQuote` not having the correct field type when writing records instead of fields.
- Fixed issue with `CharCount` and `ByteCount` when trimming.

#### Breaking Changes

- `void IWriterRow.WriteConvertedField(string field)` -> `void IWriterRow.WriteConvertedField(string field, Type fieldType)`
- `void CsvWriter.WriteConvertedField(string field)` -> `void CsvWriter.WriteConvertedField(string field, Type fieldType)`

### 23.0.0

#### Features

- Changed public `init` properties to `set`. Once VB.NET implements `init`, it can change back.
- Made method `CsvWriter.WriteBuffer` protected so sub classes can write fields.
- `CsvWriter.Flush` and `CsvWriter.FlushAsync` will now flush the underlying `TextWriter`.
- Changed all `delegate` methods to accept an args `struct` instead of parameters. This makes it easier to understand what parameters are passed in, and allows for additional parameters to be added later without a breaking change.

#### Breaking Changes

- Removed the large `CsvConfiguration` constructor. The properties are now settable, so this isn't needed for VB.NET.
- All delegates now take in a single struct argument.
  - BadDataFound
  - ConvertFromString
  - GetConstructor
  - GetDynamicPropertyName
  - HeaderValidated
  - MissingFieldFound
  - PrepareHeaderForMatch
  - ReadingExceptionOccurred
  - ReferenceHeaderPrefix
  - ShouldQuote
  - ShouldSkipRecord
  - ShouldUseConstructorParameter
  - Validate

### 22.1.2

#### Bug Fixes

- Fixed issue with data corruption when parser buffer ran out in middle of escape and quote.

### 22.1.1

#### Bug Fixes

- Fixed issue where CsvConfiguration.NewLine was being set when value is null in constructor causing IsNewLine to be true.

### 22.1.0

#### Features

- Added `[EnumIgnoreAttribute]`.

### Bug Fixes

- Fixed issue with `EnumIgnoreCase` value not making it to the converter when reading.

### 22.0.0

#### Features

- Changed `ParserMode` to `CsvMode` and added the modes to `CsvWriter`.
- Added `Type fieldType` parameter to `ShouldQuote` delegate.
- Added `TypeConverterOptions.EnumIgnoreCase` (default is false). Allows `EnumConverter` to ignore case when matching enum names, values, or `NameAttribute`.

#### Bug Fixes

- Fixed issue with `EnumConverter` when duplicate names or values appeared in an Enum.

#### Breaking Changes

- `ParserMode` -> `CsvMode`
- Added `IParserConfiguration.ProcessFieldBufferSize`.
- Added `IWriterConfiguration.Mode`.
- `ShouldQuote(string, IWriterRow)` -> `ShouldQuote(string, Type, IWriterRow)`.
- `EnumConverter` was changed to case sensitive by default.

### 21.3.1

#### Bug Fixes

- Fixed issue with CsvContext not being passed into AutoMap.

### 21.3.0

#### Features

- Added back Excel compatibility for bad data fallback.
  1. If a field doesn't start with a `Quote`, read until a `Delimiter` or `NewLine` is found.
  1. If in quoted field and a `Quote` is found that isn't preceded by an `Escape`, read until a `Delimiter or `NewLine` is found.
  1. `TrimOptions.Trim` will be applied before these rules.

### 21.2.1

#### Bug Fixes

- Fixed issue with processed field buffer not being large enough on resize.

### 21.2.0

#### Features

- Process boolean and null type converter options when writing.

### 21.1.2

#### Bug Fixes

- Fixed parsing issue with state not being reset when buffer is filled in the middle of a state.

### 21.1.1

#### Bug Fixes

- Fixed parsing issue with buffer ending in the middle of a line ending.

### 21.1.0

#### Features

- Added ParserMode.NoEscape. This will ignore quotes and escape characters.

### 21.0.6

#### Bug Fixes

- Fixed issue with writing a field that is larger then 2x the buffer size.

### 21.0.5

#### Bug Fixes

- Fixed issue with VB not being able to set `init` properties on CsvConfiguration by adding a constructor that takes in all properties as optional named arguments.

### 21.0.4

#### Bug Fixes

- Fixed issue with cache miss in on both the reader and writer.

### 21.0.3

No changes.

### 21.0.2

#### Bug Fixes

- Fixed issue with `CsvConfiguration.NewLine` not defaulting to '\r\n'.

### 21.0.1

#### Big Fixes

- Fixed issue with `CsvWriter` not keeping track of `Row` and `Index`.

### 21.0.0

#### Features

- `CsvConfiguration.NewLine` changed to a `string`. You can now read and write any string you like for a line ending. This defaults to `Environment.NewLine`. When reading, if the value is not explicitly set `\r\n`, `\r`, or `\n` will still be used.

#### Bug Fixes

- Fixed issue with other platforms than net50 using `init`.
- Fixed issue with being unable to write \r\n in an environment that does use that for `Environment.NewLine`.

#### Breaking Changes

- `char? CsvConfiguration.NewLine` changed to `string CsvConfiguration.NewLine`.

### 20.0.0

#### Features

- Parser performance.
- Writer performance.
- Changed CsvConfiguration to a read only `record` to eliminate threading issues.
- Unix parsing mode. Uses escape character instead of field quoting. Configurable `NewLine`.
- Field caching. Disabled by default. When enabled, this will cache all fields created so duplicate fields won't need to create a new string from a character array.

#### Breaking Changes

- Removed `Caches` enum.
- `ReadingContext` and `WritingContext` were merged into a single `CsvContext`. Anywhere that used either was changed to `CsvContext`.
- All `Func`s and `Action`s now have their own `delegate`.
- `ConvertUsing` renamed to `Convert`.
- `ShouldQuote` now takes in `IWriterRow` instead of `CsvContext`.
- `CsvConfiguration` changed from a `class` to a `record`.
- All `CsvConfiguration` properties changed to read only `get; init;`.
- `CsvConfiguration.NewLine` changed to `char?`.
- `CsvConfiguration.NewLineString` removed.
- `CsvConfiguration.RegisterClassMap` moved to `CsvContext`.
- `CsvConfiguration.UnregisterClassMap` moved to `CsvContext`.
- `CsvConfiguration.AutoMap` moved to `CsvContext`.
- All `IParserConfiguration` setters removed.
- `bool IParserConfiguration.CacheFields` added.
- `bool IParserConfiguration.LeaveOpen` added.
- `char? IParserConfiguration.NewLine` added.
- `ParserMode IParserConfiguration.Mode` added.
- `IParserConfiguration.IgnoreQuotes` removed.
- `char[] IParserConfiguration.WhiteSpaceChars` added.
- All `IReaderConfiguration` setters removed.
- `IReaderConfiguration.TypeConverterOptionsCache` removed.
- `IReaderConfiguration.TypeConverterCache` removed.
- `IReaderConfiguration.Maps` removed.
- `IReaderConfiguration.RegisterClassMap` removed.
- `IReaderConfiguration.UnregisterClassMap` removed.
- `IReaderConfiguration.AutoMap` removed.
- `ISerializerConfiguration` removed and properties added to `IWriterConfiguration`.
- All `IWriterConfiguration` setters removed.
- `IWriterConfiguration.QuoteString` removed.
- `IWriterConfiguration.TypeConverterCache` removed.
- `IWriterConfiguration.MemberTypes` removed.
- `IWriterConfiguration.Maps` removed.
- `IWriterConfiguration.RegisterClassMap` removed.
- `IWriterConfiguration.UnregisterClassMap` removed.
- `IWriterConfiguration.AutoMap` removed.
- `MemberMap.Optional` added.
- `MemberMap<TClass, TMember>.ConvertUsing` renamed to `Convert`.
- `CsvFieldReader` removed.
- `CsvParser.Read` returns `boolean` instead of `string[]`.
- `CsvParser` constructors that take in a `FieldReader` removed.
- `CsvParser[int index]` added to retrieve fields after a `Read`.
- `CsvSerializer` removed.
- `IFieldReader` removed.
- `IParser.ByteCount` added.
- `IParser.CharCount` added.
- `IParser.Count` added.
- `IParser[int index]` added.
- `IParser.Record` added.
- `IParser.RawRecord` added.
- `IParser.Row` added.
- `IParser.RawRow` added.
- `IParser.Read` returns `bool` instead of `string[]`.
- `IParser.ReadAsync` returns `bool` instead of `string[]`.
- `IReader.Parser` removed.
- `int IReaderRow.ColumnCount` added.
- `int IReaderRow.CurrentIndex` added.
- `string[] IReaderRow.HeaderRecord` added.
- `IParser IReaderRow.Parser` added.
- `ISerializer` removed.
- `string[] IWriterRow.HeaderRecord` added.
- `int IWriterRow.Row` added.
- `int IWriterRow.Index` added.
- `RecordBuilder` removed.

### 19.0.0

#### Features

- Added the rest of the mapping and attributes configuration for constructor parameters.
- Reading speed improvement.

#### Breaking Changes

- Added `IParameterMapper` to `BooleanFalseValuesAttribute`, `BooleanTrueValuesAttribute`, `ConstantAttribute`, `CultureInfoAttribute`, `DateTimeStylesAttribute`, `DefaultAttribute`, `FormatAttribute`, `HeaderPrefixAttribute`, `IgnoreAttribute`, `NameIndexAttribute`, `NullValuesAttribute`, `NumberStylesAttribute`, `OptionalAttribute`, and `TypeConverterAttribute`.
- Renamed `MapTypeConverterOption` to `MemberMapTypeConverterOptions`.
- Renamed `TypeConverterOptions.NumberStyle` to `TypeConverterOptions.NumberStyles`.
- Removed `ReflectionHelper.CreateInstance<T>`.
- Removed `ReflectionHelper.CreateInstance`.
- Removed `ReflectionHelper.CreateInstanceWithoutContractResolver`.

### 18.0.0

#### Features

- Added parameter mapping via class map or attributes.

#### Breaking Changes

- `NameAttribute` added interface `IParameterMapper`.
- `IndexAttribute` added interface `IParameterMapper`.

### 17.0.1

#### Bug Fixes

- Fixed issue where EnumConverter wasn't working if enum value wasn't an Int32.

### 17.0.0

#### Features

- ValidateHeader will validate all members before calling HeaderValidated.

#### Breaking Changes

- `Action<bool, string[], int, ReadingContext> IReaderConfiguration.HeaderValidated` -> `Action<InvalidHeader[], ReadingContext> IReaderConfiguration.HeaderValidated`
- `Action<bool, string[], int, ReadingContext> CsvConfiguration.HeaderValidated` -> `Action<InvalidHeader[], ReadingContext> CsvConfiguration.HeaderValidated`
- `ConfigurationFunctions.HeaderValidated` signature changed from `(bool isValid, string[] headerNames, int headerNameIndex, ReadingContext context)` to `(InvalidHeader[] invalidHeaders, ReadingContext context)`
- `CsvReader.ValidateHeader(ClassMap map)` -> `CsvReader.ValidateHeader(ClassMap map, List<InvalidHeader> invalidHeaders)`
- Removed `HeaderValidationException.HeaderNames`.
- Removed `HeaderValidationException.HeaderNameIndex`.
- Added `InvalidHeader[] HeaderValidationException.InvalidHeaders`.

### 16.2.0

#### Features

- Added ability to put `[Name]` attribute on enum values.
- Added ability to register a converter for `Enum` that will be a default for all enum types.

### 16.1.0

#### Features

- GetRecords throws `ObjectDisposedException` when `CsvReader` is disposed. A message hint was added to help the user understand what went wrong.

### 16.0.0

#### Features

- Ability to have duplicate header names when using dynamic records.

#### Breaking Changes

- Added `Func<ReadingContext, int, string> IReaderConfiguration.GetDynamicPropertyName`.
- Added `Func<ReadingContext, int, string> CsvConfiguration.GetDynamicPropertyName`.

### 15.0.10

- Fixed `IgnoreAttribute` to ignore the whole property treey if put on a reference property when auto mapped.

### 15.0.9

#### Bug Fixes

- Fixed issue where `CsvDataReader.FieldCount` was throwing an exception if there were no records.

### 15.0.8

#### Bug Fixes

- Fixed `CsvDataReader.GetOrdinal` issue where it wasn't doing a case-insensitive match after a failed case-sensitive match. Run values through `PrepareHeaderForMatch`.

### 15.0.7

#### Bug Fixes

- Fixed issue where writing `null` to `WriteField` didn't output a field.

### 15.0.6

#### Bug Fixes

- Fixed test not building.

### 15.0.5

#### Bug Fixes

- Fixed issue with multiple character delimiter not working when the first char of the delimiter precedes the actual delimiter.

### 15.0.4

#### Bug Fixes

- Fixed issue with `ReflectionHelper` caching not always unique.

### 15.0.3

#### Bug Fixes

- Updated default number styles for `DecimalConverter` and `DoubleConverter` to match MS's recommendations.

### 15.0.2

#### Bug Fixes

- Fixed issue with `DataReader.GetValues` not working when column and rows have different count.

### 15.0.1

### Bug Fixes

- Downgraded `System.Threading.Tasks.Extensions` to 4.5.2 due to loading error of `Microsoft.Bcl.AsyncInterfaces`.

### 15.0.0

#### Features

- Ignore attribute on a reference will ignore all properties on that reference.

#### Breaking Changes

- Added `IMemberReferenceMapper` to `IgnoreAttribute`.

### 14.0.0

#### Features

- Added `IAsyncDispose` on writing classes.

#### Breaking Changes

- Added dependency `<PackageReference Include="System.Threading.Tasks.Extensions" Version="4.5.3" />` to `net45`.
- Added dependency `<PackageReference Include="System.Threading.Tasks.Extensions" Version="4.5.3" />` to `net47`.
- Added dependency `<PackageReference Include="System.Threading.Tasks.Extensions" Version="4.5.3" />` to `netstandard2.0`.
- `IWriter` added interface `IAsyncDisposable` for `net47` and `netstandard2.1`.
- `ISerializer` added interface `IAsyncDisposable` for `net47` and `netstandard2.1`.
- `WritingContext` added interface `IAsyncDisposable` for `net47` and `netstandard2.1`.
- `CsvWriter` added methods `public async ValueTask DisposeAsync()` and `protected virtual async ValueTask DisposeAsync(bool disposing)` for `net47` and `netstandard`.
- `CsvSerializer` added methods `public async ValueTask DisposeAsync()` and `protected virtual async ValueTask DisposeAsync(bool disposing)` for `net47` and `netstandard`.
- `WritingContext` added methods `public async ValueTask DisposeAsync()` and `protected virtual async ValueTask DisposeAsync(bool disposing)` for `net47` and `netstandard`.

### 13.0.0

#### Features

- Added `netstandard2.1` build.
- Added required CultureInfo parameter to any class that uses CultureInfo.
- Apply member attributes using interface instead of hard coding.
- Added customizable new line when writing. You can choose from `CRLF`, `CR`, `LF`, or `Environment.NewLine`.
- Renamed `Configuration` to `CsvConfiguration` to avoid namespace conflicts.
- Added `GetRecordsAsync` and `WriteRecordsAsync`.

#### Breaking Changes

- Removed dependency `<PackageReference Include="System.Reflection.TypeExtensions" Version="4.4.0" />` from `netstandard2.0`.
- Removed dependency `<PackageReference Include="System.Reflection.TypeExtensions" Version="4.4.0" />` from `netstandard2.1`.
- Added dependency `<PackageReference Include="Microsoft.Bcl.AsyncInterfaces" Version="1.1.0" />` to `net47`.
- Added dependency `<PackageReference Include="Microsoft.Bcl.AsyncInterfaces" Version="1.1.0" />` to `netstandard2.0`.
- `ClassMap.AutoMap()` -> `ClassMap.AutoMap(CultureInfo)`
- `CsvParser.CsvParser(TextReader)` -> `CsvParser.CsvParser(TextReader, CultureInfo)`
- `CsvParser.CsvParser(TextReader, bool)` -> `CsvParser.CsvParser(TextReader, CultureInfo, bool)`
- `CsvReader.CsvReader(TextReader)` -> `CsvReader.CsvReader(TextReader, CultureInfo)`
- `CsvReader.CsvReader(TextReader, bool)` -> `CsvReader.CsvReader(TextReader, CultureInfo, bool)`
- `CsvSerializer.CsvSerializer(TextWriter)` -> `CsvSerializer.CsvSerializer(TextWriter, CultureInfo)`
- `CsvSerializer.CsvSerializer(TextWriter, bool)` -> `CsvSerializer.CsvSerializer(TextWriter, CultureInfo, bool)`
- `CsvWriter.CsvWriter(TextWriter)` -> `CsvWriter.CsvWriter(TextWriter, CultureInfo)`
- `CsvWriter.CsvWriter(TextWriter, bool)` -> `CsvWriter.CsvWriter(TextWriter, CultureInfo, bool)`
- `Factory.CreateParser(TextReader)` -> `Factory.CreateParser(TextReader, CultureInfo)`
- `Factory.CreateReader(TextReader)` -> `Factory.CreateReader(TextReader, CultureInfo)`
- `Factory.CreateWriter(TextWriter)` -> `Factory.CreateWriter(TextWriter, CultureInfo)`
- `IFactory.CreateParser(TextReader)` -> `IFactory.CreateParser(TextReader, CultureInfo)`
- `IFactory.CreateReader(TextReader)` -> `IFactory.CreateReader(TextReader, CultureInfo)`
- `IFactory.CreateWriter(TextWriter)` -> `IFactory.CreateWriter(TextWriter, CultureInfo)`
- Added `ISerializerConfiguration.NewLine`.
- Added `ISerializerConfiguration.NewLineString`.
- Added `Configuration.NewLine`.
- Added `Configuration.NewLineString`.
- Removed `Configuration.Configuration()` parameterless constructor.
- Attributes now require the use of `IMemberMapper` or `IMemberReferenceMapper` to be loaded. All existing attributes added these and implemented the interface.
- Renamed `Configuration` to `CsvConfiguration`.
- Added `IAsyncEnumerable<T> CsvReader.GetRecordsAsync<T>()`
- Added `IAsyncEnumerable<T> CsvReader.GetRecordsAsync<T>(T anonymousTypeDefinition)`
- Added `IAsyncEnumerable<object> CsvReader.GetRecordsAsync(Type type)`
- Added `IAsyncEnumerable<T> CsvReader.EnumerateRecordsAsync<T>(T record)`
- Added `Task CsvWriter.WriteRecordsAsync(IEnumerable records)`
- Added `Task CsvWriter.WriteRecordsAsync<T>(IEnumerable<T> records)`
- Added `IAsyncEnumerable<T> IReader.GetRecordsAsync<T>()`
- Added `IAsyncEnumerable<T> IReader.GetRecordsAsync<T>(T anonymousTypeDefinition)`
- Added `IAsyncEnumerable<object> IReader.GetRecordsAsync(Type type)`
- Added `IAsyncEnumerable<T> IReader.EnumerateRecordsAsync<T>(T record)`
- Added `Task IWriter.WriteRecordsAsync(IEnumerable records)`
- Added `Task IWriter.WriteRecordsAsync<T>(IEnumerable<T> records)`

### 12.3.2

#### Bug Fixes

- Changed double and single converters to only test for format "R" if the user hasn't supplied a format.

### 12.3.1

#### Bug Fixes

- Fix for bug in .NET Framework that causes a StackOverflowException. This needs to be changed back eventually.

### 12.3.0

#### Features

- Added UriConverter.

### 12.2.3

#### Big Fixes

- Changed round trip default format to test if "R" works and use backup of "G9" for float and "G17" for double.

### 12.2.2

#### Bug Fixes

- Fixed issue where multiple properties with the same name were used when a child class property hides a parent class property using the new modifier.
- Fixed issue where a null reference exception was thrown when writing and all properties are ignored.

### 12.2.1

#### Bug Fixes

- Fixed issue where an "Index out of bounds of the array" exception was happening on TryGetField of type DateTime.
- Fix `RawRecord` adding spaces if `TrimOptions.Trim` is used.

### 12.2.0

#### Features

- Allow default value when using optional members.
- Added BigIntConverter.
- Mapping to member with type `Type` will throw exception by default.

#### Bug Fixes

- Made SingleConverter and DoubleConverter round-trip-able.

### 12.1.3

#### Bug Fixes

- Always write \r\n line endings to be compliant with RFC 4180.

### 12.1.2

#### Bug Fixes

- Fixed issue where CsvDataReader would skip the first row when there is no header record.
- Fixed CsvDataReader issue where null values weren't being represented as DBNull.Value on GetValue and GetValues methods.
- Fixed issue with IsDBNull method where an empty string was considered a null.

### 12.1.1

#### Bug Fixes

- Fixed issue where `CsvReader.ReadAsync` wasn't behaving the same as `CsvReader.Read`.

### 12.1.0

#### Features

- Added constructor to `Configuration` to pass in the `CultureInfo`. When passing a culture in, the `Delimiter` will be set to `CultureInfo.TextInfo.ListSeparator`.

### 12.0.1

#### Bug Fixes

- Fixed issue where writing a dynamic object would still sort the header when no sort was specified.

### 12.0.0

#### Features

- Added config option for sorting dynamic object properties when writing. Defaults to property value set order.

#### Breaking Changes

- Added `IComparer<string> IWriterConfiguration.DynamicPropertySort`.
- Added `IComparer<string> Configuration.DynamicPropertySort`.

### 11.0.1

#### Bug Fixes

- Fixed issue with leaveOpen not being used in the context's dispose.

### 11.0.0

#### Features

- Removed config options `QuoteAllFields`, `QuoteNoFields`, `QuoteRequiredChars`, and `BuildREquiredQuoteChars` in favor of `ShouldQuote` function.

#### Breaking Changes

- Removed `IWriterConfiguration.QuoteAllFields`.
- Removed `IWriterConfiguration.QuoteNoFields`.
- Removed `IWriterConfiguration.QuoteRequiredChars`.
- Removed `IWriterConfiguration.BuildRequiredQuoteChars`.
- Removed `Configuration.QuoteAllFields`.
- Removed `Configuration.QuoteNoFields`.
- Removed `Configuration.QuoteRequiredChars`.
- Removed `Configuration.BuildRequiredQuoteChars`.
- Added `Func<string, WritingContext, bool> IWriterConfiguration.ShouldQuote`.
- Added `Func<string, WritingContext, bool> Configuration.ShouldQuote`.

### 10.0.0

#### Features

- Added a more friendly header validation message.
- Separated header and field validation exceptions.
- Added data properties to validation classes.
- Changed Configuration.ReadingExceptionOccurred to not throw an exception and return a boolean whether it should throw an exception. The caller will throw if true.
- Changed `NamedIndexCache` type from `Tuple<string, int>` to `(string, int)`.
- Config option to consider a line break in a quoted field as bad data.
- Changed delimiter default value from ',' to CultureInfo.CurrentCulture.TextInfo.ListSeparator.
- PrepareHeaderForMatch now passes in the header name and index.
- Dynamic records will now have null properties for missing fields.
- Write ExpandoObject and IDynamicMetaObjectProvider object properties in ascending order to ensure order of property creation doesn't matter.
- Added escape character configuration.
- Added IDataReader implementation. This allows for easily loading a DataTable.

### Breaking Changes

- `ValidationException` is now `abstract`.
- `IReaderConfiguration.ReadingExceptionOccurred` type changed from `Action<CsvHelperException>` to `Func<CsvHelperException, bool>`.
- `Configuration.ReadingExceptionOccurred` type changed from `Action<CsvHelperException>` to `Func<CsvHelperException, bool>`.
- Changed `NamedIndexCache` type from `Tuple<string, int>` to `(string, int)`. This adds a dependency to `System.ValueTuple` on .NET 4.5.
- Added `bool IParserConfiguration.LineBreakInQuotedFieldIsBadData`.
- Added `bool Configuration.LineBreakInQuotedFieldIsBadData`.
- Changed `IReaderConfiguration.PrepareHeaderForMatch` type from `Func<string, string>` to `Func<string, int, string>`.
- Changed `Configuration.PrepareHeaderForMatch` type from `Func<string, string>` to `Func<string, int, string>`.
- Added `char ISerializerConfiguration.Escape`.
- Added `char IParserConfiguration.Escape`.
- Added `char Configuration.Escape`.

### 9.2.3

#### Bug Fixes

- Fixed issue where TrimOptions.InsideQuotes would fail when there were escaped quotes in the field.

### 9.2.2

#### Bug Fixes

- Fixed issue where NamedIndexes wasn't being reset on ReadHeader call.

### 9.2.1

#### Bug Fixes

- Fixed issue where a TypeConverterAttribute isn't being used when on a reference.

### 9.2.0

#### Features

- More clear exception messages when reading and a missing field is found.

### 9.1.0

#### Features

- Allow parameterless constructor on classes and reference property classes when auto mapping.

### 9.0.2

#### Bug Fixes

- Fixed issue where `WriteAsync` wasn't calling `SanitizeForInjection`.

### 9.0.1

#### Bug Fixes

- Fixed issue where `leaveOpen` parameter in `CsvParser` constructor was hard coded.
- Fixed issue where header validation was being ran on properties that only had an index mapped.

### 9.0.0

This release contains changes from 8.3.0 and 8.2.0.

### 8.3.0

This has been unlisted in nuget because of a breaking change before it. The changes are in 9.0.0.

#### Features

- Removed restriction that was disallowing the null char '\0' to be used as a delimiter.

### 8.2.0

This has been unlisted in nuget because of a breaking change. The changes are in 9.0.0.

#### Features

- Added Optional config to factory builder.
- Added `OptionalAttribute`.

#### Breaking Changes

- Added `IHasMapOptions : IHasOptional`.
- Added `MemberMapBuilder : IHasOptional`.
- Added `MemberMapBuilder : IHasOptionalOptions`.

### 8.1.1

#### Features

- Configuration functions are available on a static class `ConfigurationFunctions`.

#### Bug Fixes

- Fixed issue where `IgnoreBlankLines` wasn't being checked in `GetField<T>(int index, ITypeConverter converter)`.

### 8.1.0

#### Features

- Added `IsOptional` mapping option.

### 8.0.0

#### Features

- Added Unity build.
- Added `IsOptional` mapping option.

#### Bug Fixes

- Added missing interface methods to configs.
- Fixed issue with parsing when only CR is used and fields are quoted.
- Fixed issue where `GetField` was calling the `ObjectResolver`.
- Made the contexts not serializable in exceptions.
- Fixed issue with `ObjectResolver` fallback causing a `StackOverflowException`.

#### Breaking Changes

- Added `IReaderConfiguration.IgnoreReferences`.
- Added `IWriterConfiguration.IgnoreReferences`.

### 7.1.1

#### Bug Fixes

- Added constructor to `CsvWriter` that allows for `leaveOpen` to be set.
- Made `CsvWriter.Dispos`e able to be called multiple times.
- Added `ConfigureAwait(false)` to all async calls.

### 7.1.0

#### Features

- Changed record object creation to use the `ObjectResolver`.

### 7.0.1

#### Bug Fixes

- Allow private constructors to be used to instantiate new class instances.

### 7.0.0

#### Features

- Reading performance improvements.

#### Breaking Changes

- Removed `IReadingContext` and `IWritingContext` interfaces. `ReadingContext` and `WritingContext` are used directly now.

### 6.1.1

#### Bug Fixes

- Fixed issue with circular references when auto mapping.

### 6.1.0

#### Features

- Dynamic now uses `Configuration.PrepareHeaderForMatch` on header name to get property name for dynamic object.

### 6.0.3

#### Bug Fixes

- Fixed issue with LINQPad not working properly due to types from differently assemblies being cached in the writer.

#### Breaking Changes

- `IWritingContext.TypeActions` signature changed.

### 6.0.2

#### Bug Fixes

- Fixed issue with LINQPad not working properly due to types from differently assemblies being cached.

### 6.0.0

#### Features

- Use `ObjectResolver` to create internal classes `RecordManager`, `ExpressionManager`, `RecordCreatorFactory`, and `RecordHydrator`, `RecordWriterFactory`.
- Added generic resolve method to object resolver.
- Added mapping methods to MemberMap for use during runtime mapping.
- Added more info and properties to TypeConverterException.

#### Bug Fixes

- Fixed issue where mapping an interface doesn't get used when writing.

#### Breaking Changes

- Added `IObjectResolver.Resolve<T>( params object[] constructorArgs )` method.
- Added `IWriter.WriteRecords<T>( IEnumerable<T> records )` method.
- `TypeConverterException` constructors signatures changed.

### 5.0.0

#### Features

- Added `Map<TClass>.References( expression )` back in.

#### Bug Fixes

- Fixed `DefaultTypeConverterException` message. The generated message wasn't being used.

### 4.0.3

#### Bug Fixes

- Added `ReadingExceptionOccurred` callback to `GetRecord` methods when an exception occurs.

### 4.0.2

#### Bug Fixes

- Fixed issue with parsing when buffer spans over a field.

### 4.0.1

#### Bug Fixes

- Fixed issue where trimming inside quotes would fail when the character after a space was a delimiter, \r, or \n.

### 4.0.0

#### Breaking Changes

- Added setter to `ISerializerConfiguration.Quote`.
- Removed `ClassMap<TClass>.References( expression, constructorArs )`. Use sub property mapping instead.
- Removed `ClassMap<TClass>.ConstructUsing( expression ). Use the `ObjectResolver` instead.
- Change how reference header prefixing works.
 - Changed `Configuration`/`IReaderConfiguration`/`IWriterConfiguration` `bool PrefixReferenceHeaders` to `Func<Type, string, string> ReferenceHeaderPrefix`. The function takes in the member type and member name and returns the prefix.
 - Removed `MemberReferenceMap.Prefix()` method.
 - Removed `ParameterReferenceMap.Prefix()` method.
- Changed `Configuration`/`IReaderConfiguration`/`IWriterConfiguration` `ClassMap AutoMap<T>()` to `ClassMap<T> AutoMap<T>()`
- Changed `TypeConverterException` constructors parameter from `ReadingContext` to `IReadingContext`.

### 3.4.0

#### Bug Fixes

- Fixed issue when a map was created through auto mapping, you couldn't use sub property mapping to update a member.

### 3.3.0

#### Features

- Added more information to the `DefaultTypeConverter.ConvertFromString` not convertible exception.
- Reduced the number of `PrepareHeaderForMatch` calls.

### 3.2.0

#### Features

- Attribute mapping. It's back...

### 3.1.1

#### Bug Fixes

- Fixed issue where you weren't able to write `IEnumerable`.

### 3.1.0

#### Features

- Allow multiple headers to be written.

#### Bug Fixes

- Flush `CsvWriter` on `Dispose`.
- Made `ShouldSkipRecord` not called if the parser returns `null` for an end of stream.
- `ShouldUseConstructorParameters` returns `false` if there are no constructors.
- Header validation doesn't validate members where `ConvertUsing` or `Constant` are used.

### 3.0.0

#### Features

- netstandard2.0
- Massive speed improvements to the `CsvParser`.
- Speed improvements to `CsvSerializer`.
- Map child properties so multiple mapping classes aren't needed.
- `ConvertUsing` implementation for writing.
- Read/write `IEnumerable` properties.
- Field mapping.
- Async reading/writing.
- Added `ClassMapBuilder` to build maps on the fly without a mapping class.
- Write `IDynamicMetaObjectProvider` objects. `DynamicObject` and `ExpandoObject` are the 2 most common.
- Allow `null` fields to be written.
- `IDictionary` type converters.
- Added trim options to trim in parser and removed trim from reader.
- Header validation.
- Field validation.
- Added `leaveOpen` flag to constructors to not dispose of underlying `TextReader` and `TextWriter`.
- Added properties to `CsvHelperException` and removed the string data.
- Speed up mappings that use `ConvertUsing` by caching the named indexes.
- Write comments.
- Map constants.
- Write fields that aren't mapped.
- Specify values that resolve to `null` when reading.
- Added CsvProperMap<T> to allow for compile time type checking on mappings.
- Read more than 1 header row.
- Changed reading exception callback to send a CsvHelperException.
- Map the same property more than once.
- Exposed the underlying TextReader as a property.
- Removed header matching manipulation configuration `IsHeaderCaseSensitive`, `IgnoreHeaderWhiteSpace`, and `TrimHeaders` and added a config for `PrepareHeaderForMatch` that is a function. Both the header field name and the property name are ran through this method before matching against each other.
- Added interfaces for configuration so you can tell what options are available in your current context.
- Moved detection of column count changes into the reader. The parser shouldn't care and should just return whatever data it finds.
- `ConstructUsing` works with reference maps.
- `ConstructUsing` can use initializers.
- Allow resuming reading of more data is written to the stream.
- Auto mapping with user defined `struct`.
- Ability to change required quote characters.
- Speed improvements when using `GetField`.
- Speed improvements when using `WriteField`.
- Allow mapping default value to be a string that is converted.
- Moved reading/writing state data into a common context object that is shared.
- Multiple `string` formats for `TypeConverterOptions`.
- Created object resolver so interfaces can be mapped to and IoC containers can be plugged in.
- Made methods `ReIndex` and `GetMaxIndex` on `CsvClassMap` `public`.
- Added a `Flush` method to the writer so `NextRecord` just writes a line ending. This will allow users to not write a line ending if they want.
- Removed statics to eliminate possible threading issues.
- Added `SerializableAttribute` to exception classes. It was removed previously because of netstandard1.x not having it available.
- Added `ByteArrayConverter`.
- Reading anonymous types.
- Auto mapping with any constructor.
- Changed `Property` naming to `Member` since both properties and fields are used.
- `TypeConverterFactory` is now instance of `Configuration` instead of a static.
- Changed `Configuration` flags to callbacks with default functionality to let the user change the functionality if they want.

#### Bug Fixes

- Fixed issue with `CsvClassMapCollection[type]` choosing the wrong type when multiple types on the inheritance tree are mapped.
- Fixed issue where setting `Configuration.ShouldSkipRecord` method always overrides the `Configuration.SkipEmptyRecords` setting.
- Fixed issue where ignoring header whitespace wouldn't work if a named property had the same whitespace in it.
- When comments are on and a field is being written that is the first field in the record and the first char is a comment char, quote the field because it's not a comment.
- Fixed issue with type converter options set in factory not working with auto mapping or explicit map.
- Fixed line ending spanning buffer issue.
- Fixed issue of skipping a character if a line ending was within a quoted field.
- Added locking to factory to make it thread safe.
- Fixed bug when mapping a constant then mapping another property after will throw an exception.
- Changed reflection calls to `ConvertToString` to get the method for `ITypeConverter` instead of the actual converter. This is so the overridden implementation will be used instead of a random method with the same name.
- Adding locking in `ReflectionHelper.CreateInstance` for the static delegate cache.
- Fixed quote handling issue of `IsFieldBad` by marking unquoted fields with quote chars as bad only when `Configuration.IgnoreQuotes` is `false`.
- Fixed issue with automapping not mapping references correctly in some nested situations because it thought it was a circular dependency when it wasn't.
- Fixed issue with private properties not being able to be set.
- Fixed issue with getting the class map from the collection. It was only getting the current and not looking up the tree.
- Fixed issue with `Constant` not working with `null`.

#### Breaking Changes

- Removed all .NET builds except for net45 and netstandard2.0.
- Removed obsolete code.
 - `object ICsvReader.GetField( int index, ITypeConverter converter )`
 - `object ICsvReader.GetField( string name, ITypeConverter converter )`
 - `object ICsvReader.GetField( string name, int index, ITypeConverter converter )`
 - `void ICsvWriter.WriteField( Type type, object field )`
 - `void ICsvWriter.WriteField( Type type, object field, ITypeConverter converter )`
 - `void ICsvWriter.WriteRecord( Type type, object record )`
- Moved methods that aren't row level out of `ICsvReaderRow` and into `ICsvReader`.
 - `IEnumerable<T> GetRecords<T>()`
 - `IEnumerable<object> GetRecords( Type type )`
 - `void ClearRecordCache<T>()`
 - `void ClearRecordCache( Type type )`
 - `void ClearRecordCache()`
- Removed `CanConvertTo` and `CanConvertFrom` from the type converters because there is no need for them.
- Added properties to `CsvHelperException` and removed the string data.
- Changed `WriteRecord` to not call `NextRecord`.
- Changed config setting name from `IgnorePrivateAccessor` to `IncludePrivateProperties` to be more clear on intention.
- Changed reading exception callback to send a `CsvHelperException`.
- Removed configuration `IsHeaderCaseSensitive`, `IgnoreHeaderWhiteSpace`, and `TrimHeaders` and added `PrepareHeaderForMatch`.
- Changed `DateTime` and `DateTimeOffset` converters to not work when the `string` is spaces to match what all the other converters do. The .NET Framework `DateTime` and `DateTimeOffset` converters will convert a `string` of all spaces into `MinValue`, so we are diverging from that a little.
- Changed `ReadHeader` to not set `CurrentRecord` to `null`.
- Removed Excel specific code. This will go into a separate library. The malformed fallback behavior that mimics Excel still exists.
- Moved reading/writing state data into a common context object that is shared.
- Changed `BadDataCallback` to take in a `ReadingContext` instead of a `string`.
- Removed `Csv` prefix from all classes except `CsvReader`, `CsvParser`, `CsvWriter`, and `CsvSerializer`.
- Removed default `null` values since there is no common standard that could be found.
- Removed default `boolean` values of `yes`, `y`, `no`, `n` since it's not a standard boolean. `true`, `false`, `1`, `0` still work.
- Changed default delimiter to `,` instead of ListSeparator.
- Added a `Flush` method to the writer.
- Changed `Property` naming to `Member`.
- Removed `Configuration`s `ThrowOnBadData`, `IgnoreReadingExceptions`, `SkipEmptyRecords`, and `WillThrowOnMissingField` in favor of function callbacks.
- Renamed
  - `TypeConverterFactory` to `TypeConverterCache`
  - `TypeConverterOptionsFactory` to `TypeConverterOptionsCache`
  - `Configuration.HeaderValidatedCallback` to `Configuration.HeaderValidated`
  - `Configuration.MissingFieldFoundCallback` to `Configuration.MissingFieldFound`
  - `Configuration.ReadingExceptionCallback` to `Configuration.ReadingExceptionOccurred`
  - `Configuration.BadDataFoundCallback` to `Configuration.BadDataFound`
  - `ICsvParser` to `IParser`
  - `FieldReader` to `CsvFieldReader`
  - `ICsvReader` to `IReader`
  - `ICsvReaderRow` to `IReaderRow`
  - `ICsvSerializer` to `ISerializer`
  - `ICsvWriter` to `IWriter`
  - `ICsvWriterRow` to `IWriterRow`

### 2.16.3

#### Bug Fixes

- Fixed issue with `CsvClassMapCollection[type]` choosing the wrong type when multiple types on the inheritance tree are mapped.

### 2.16.2

#### Bug Fixes

- Made `TypeInfo` compatibility stuff internal to not cause conflicts.

### 2.16.1

#### Bug Fixes

- Fix for UWP release not working.

### 2.16

#### Features

- Added `CsvReader.ReadHeader` so headers can be read without reading the first row.

### 2.15.0.2

#### Features

- Update to .NET Core 1.0 release.

### 2.15

#### Features

- Added `SerializableAttribute` to all exceptions.

### 2.14.3

#### Features

- Updated project to .NET Core RC2.

#### Bug Fixes

- Fixed issue with assembly not being a release build.

### 2.14.2

#### Bug Fixes

- Added net45 build and excluded it from CoreFX compatibility.

### 2.14.1

#### Bug Fixes

- Fixed issue with .NET 2.0 classes being included that shouldn't have been in .NET 4.0.

### 2.14

#### Features

- Added CoreCLR support.

### 2.13.5

#### Bug Fixes

- Fixed `ShouldSkipRecord` not working on rows before header.

### 2.13.3

#### Bug Fixes

- Fixed issue where the number of delimiter characters was read when a multiple character delimiter is hit. This was causing non-delimiters to be read when just the first character of the delimiter was found.

### 2.13.2

#### Bug Fixes

- Fixed issue with `TryGetField` with named index returning wrong value.

### 2.13.1

#### Bug Fixes

- Added missing `DateTimeConverter` to the list of default converters.

### 2.13

#### Features

- When writing, use empty values for properties on reference properties when flag `UseNewObjectForNullReferenceProperties` is off.

#### Bug Fixes

- Fixed portable target for Windows Phone 8.1.

### 2.12

#### Features

- Added Windows Phone 8.1 support to the PCL assembly.
- Added ability to set a prefix for reference maps. i.e. `Prefix( string prefix = null)`
- Added callback to use to determine if a record should be skipped when reading.
- Excel leading zeros number formatting. This allows you to read and write numbers that will preserve the zeros on the front. i.e. `="0001"`
- Use default value when a field is null because of a missing field in the row.
- Added `TrimFields` to CsvWriter.
- ability to specify constructor arguments when referencing another map within a mapping.
- Added `Names` property on `CsvPropertyNameCollection` to get raw list of property names.
- Added raw file line number to parser.
- Mapping methods on `CsvClassMap<T>` are now public to more easily allow mapping during runtime.
- Added `DateTimeOffset` converter.

#### Bug Fixes

- Fixed exception that was occurring when fields were empty and `UseExcelLeadingZerosFormatForNumerics = true`.
- Excel compatibility fix. If a field starts with a quote but never ends and the end of the file is reached, the field would be null. The field will now contain everything.
- Don't get static properties when automapping.
- Made all exceptions thrown contain Exception.Data["CsvHelper"].
- Fixed missing support writing the double quotes for inner quotes on a quoted field. This used to be there and was removed at some point. A unit test is now in place so this doesn't happen again.

### 2.11.1.1

#### Bug Fixes

- Fixed issue with writing an array of records.

### 2.11

#### Features

- Allow preservation of numeric strings for Excel.

#### Bug Fixes

- Fixed writing issue with anonymous objects outputting wrong headers.

### 2.10

#### Features

- Updated writer methods to match reader methods.

### 2.9.1

#### Bug Fixes

- Fixed issue where char converter would trim a single space string.

### 2.9

#### Features

- Added support to ignore whitespace when determining a record is empty.

### 2.8.4

#### Bug Fixes

- Fixed breaking change to not break.

### 2.8.3

#### Bug Fixes

- Fixed issue where header wasn't written when there were no records in the IEnumerable on WriteRecords( IEnumerable ).

### 2.8.2

#### Bug Fixes

- Fixed issue where an exception was always thrown if Configuration.ThrowOnBadData is on.

### 2.8

#### Features

- Added configurations for a callback when a bad field is detected. Added configuration to throw an exception when a bad field is detected.
- Made mapping with interfaces not duplicate property maps.

### 2.7.1

#### Bug Fixes

- Fixed issue with mappings overwriting an explicitly set index when re-indexing.
- Auto mapping will ignore Enumerable properties instead of throwing an exception. Exceptions will still be thrown if an Enumerable is used outside of auto mapping.

### 2.7

#### Bug Fixes

- Fixed issue where using dynamic proxy objects would always automap instead of using a registered class map.
- Fixed issue when trimming fields and the field is null.
- Fixed issue when writing a field and the value is null.
- Removed deprecated writer methods.

### 2.6.1

#### Features

- PCL implementation. .NET 4.0+, Silveright 4.0+, WP7 7.5+, Windows 8
- Excel separator record reading and writing.
- Writer speed enhancements. Thanks to thecontrarycat.

#### Bug Fixes

- Fixed issue with mapping order when no index is specified.

### 2.6

#### Features

- Added config to prefix headers of reference properties with the parent property name when automapping.
- Ability to ignore blank lines. When this config option is set to false, the parser will return and array of nulls. You can differentiate between a row with commas this way. The reader will behave the same way as a blank record.

#### Bug Fixes

- Fixed issue when writing and a reference map type is a struct.

### 2.5

#### Features

- Global type converter options.
- Easier access to property maps to allow for changing maps on the fly.
- Option to ignore references when auto mapping.
- AutoMap functionality is available in class maps.
- Mappings can be specified in the constructor of the mapping class. Overriding CreateMap is now deprecated.

#### Bug Fixes

- Updated ConvertUsing to not cause the exception "Operation Could Destabilize the Runtime" when property is a nullable type and a non-nullable type is returned.

### 2.4.1

#### Bug Fixes

- Fixed issue where parsing would add delimiter chars to the field when the buffer ran out in the middle of the delimiter.

### 2.4

#### Features

- Split writing up into a writer and serializer so the writer can write other things besides CSV files.

#### Bug Fixes

- Fixed issue where a NullReferenceException was thrown when using reference maps and a reference was null.
- Fixed issue where TryGetField was throwing MissingFieldException.
- Fixed issue where a commented row on the last line that doesn't have a newline will return the commented row.
- Fixed NuGet package for WP8.
- Added missing WriteHeader methods to ICsvWriter that were a part of CsvWriter.

### 2.3

#### Features

- Support for TimeSpan.
- Support for writing records of type dynamic. The dynamic objects do not work with collections, which means ExpandoObject doesn't currently work.

#### Bug Fixes

- Fixed issue with extra exception info not being added when the reading exception callback is used.
- Fixed issue where having only reference maps throws exception.

### 2.2.2

#### Bug Fixes

- Fixed issue with parser where a line wouldn't end if the previous char was a \0.

### 2.2.1

#### Bug Fixes

- Fixed issue with trimming fields not working under one path.
2.2.0

#### Features

- Added Row property to ICsvReader.
- Config option to trim headers and values when reading.

### 2.1.1

#### Bug Fixes

- Fixed issue when WillThrowOnMissingField is off and exception was still being thrown.

### 2.1.0

#### Features

- Made RegisterClassMap overload with CsvClassMap instance public.

### 2.0.1

#### Bug Fixes

- Made a WinRT Any CPU build and removed the arch specific WinRT builds.

### 2.0.0

#### Features

- Added parser configuration to ignoring quotes and treating them like any other character.
- Added CsvFactory to create ICsvParser, ICsvReader, and ICsvWriter classes. This is useful when you need to unit test code that uses CsvHelper since these 3 classes require a TextReader or TextWriter to work.
- All assembly versions are strong named but will use a single version of 2.0.0.0. The file version and NuGet versions will change with every release.
- Removed class type constraint from reading and writing.
- Added non-generic class mapping overload.
- WriteRecords param changed from IEnumerable<object> to non-generic IEnumerable.
- Value types can be read and written instead of just custom classes.
- Indexes are automatically set and incremented when mapping in order of the Map and Reference calls.
- Auto mapping with circular reference detection.
- Config option to ignore spaces in header names.
- Fixed exception handling. Exception are no longer wrapped. Exception.Data["CsvHelper"] contains CsvHelper specific exception info.
- Row exception can be skipped during GetRecords.
- Renamed IsStrictMode to WillThrowOnMissingField.
- Window Phone 7 & 8 builds.
- Auto mapping will use defined maps if available.
- Type converter options.
- Added IEnumerable converter that throws an exception so people will know that converting to/from and enumerable is not supported instead of getting a cryptic error message.
- Dynamic support for reading and writing.
- Multiple maps can be supplied.
- Renamed InvalidateRecordCache to ClearRecordCache.
- Recursive reference mapping down the whole mapping tree.
- Configuration.CultureInfo was added in place of Configuration.UseInvariantCulture.

#### Bug Fixes

- Getting the exception helper message failed when writing because no parser is available.
- WriteRecords Dynamic invoke had wrong parameter count.
- GetField( string ) was not returning null if the header is not found.
- CsvBadDataException when there were extra columns in the row.
- Raw record corruption.

### 1.17.0

#### Features

- Ignore properties that can't be set in attribute mapping.
- Made TypeConverterFactory thread safe.
- Added remove converter method.

#### Bug Fixes

- Issue with writer exception in WinRT.

### 1.16.0

#### Features

- Change TypeConverterFactory to use a set of cache type converters so global type converters can be used.
- Added GetField<T, TConverter> overloads.
- Changed all Activator.CreateInstance calls to use compiled expression trees to create them instead.
- Changed mapping for ConvertUsing to accept a Func so a block expression can be used.

### 1.15.0

#### Features

- Support for Silverlight 4 & 5.

#### Bug Fixes

- Issue where writing with Configuration.QuoteAllFields enabled will not quote the quotes inside the field.
- Issue with WinRT not building after pull request merge.

### 1.14.0

#### Features

- Parse full line on read. This allows for the parser to retain the whole unchanged raw CSV lin on a read.
- Changed delimiter config from a char to a string.
- Iterating records multiple times will throw a CsvReaderException. This is to help stop confusion when 0 results are returned the second iteration.

#### Bug Fixes

- Issue where EnumConverter isn't created correctly from the TypeConverterFactory.
- Issue with updating count for all closing quotes.

### 1.13.0

#### Features

- Configuration to always not quote all fields.
- WriteHeader method is public.
- Added enum converter.

#### Bug Fixes

- Issue with boolean converter returning true for "no" value.
- Issue with GetMethod in WinRT.

### 1.12.1

#### Bug Fixes

- Issue where an exception was being thrown when reading all records multiple times.

### 1.12.0

#### Features

- WinRT support.

### 1.11.0

#### Features

- Better exception information added to CsvBadDataException.

### 1.10.0

#### Features

- Mapping property for CreateUsing which allows user to specify how the property gets created.

### 1.9.2

#### Bug Fixes

- Issue with skipping empty records.

### 1.9.1

#### Bug Fixes

- Issue with detecting column count changes.

### 1.9.0

#### Features

- Added properties to CsvReaderException to give more information about the error.
- Ability to skip empty records based on config settings.
- Getting by index that doesn't exist will give a default or CsvMissingFieldException.
- Made column count detection a config setting.
- Map option for constructing the row object.
- Throw exception when inconsistent column lengths are detected.
- String.Format support in CsvWriter.
- Excel compatible parsing.
- Parser can keep track of the byte position using an encoding so a user can seek to a stream and start reading from there.

#### Bug Fixes

- Fixed bug with column count detection.
- Issue with double counting the closing quote.
- Issue where parsing was incorrect when the last row didn't have a CRLF at the end.
- Issue with error messages.

### 1.8.0

#### Features

- Writer overload for shouldQuote when writing a field.
- Ability for using alternative names for headers in the configuration.
- Better error messages.

### 1.7.0

#### Features

- Configuration to quote all fields when writing.
- Parser keeps a char count of where it's at.

#### Bug Fixes

- Fixed subclass issue by having the reader and writer use interfaces instead of concrete classes.

### 1.6.0

#### Features

- Custom boolean type converter that can convert from 1 and 0 besides the normal conversion.
- Property map configuration to set a default value.
- CsvWriter no longer flushes to the output stream after every record.
- Non-generic overloads for reading, writing, and attribute mapping.
- Invalidate record cache will clear the properties list.

### 1.5.0

#### Features

- Support .NET 2.0 and 3.5 builds.

### 1.4.0

#### Features

- Case insensitive header matching.

### 1.3.0

#### Features

- Removed CsvHelper class.
- Property reference mapping. One level deep.

### 1.2.0

#### Features

- Support for multiple duplicate header names.

### 1.1.2

#### Bug Fixes

- Issue when using a readonly or writeonly stream and disposing causes an exception.

### 1.1.1

#### Features

- Updated CsvHelper.cs to allow for readonly and writeonly stream.

#### Bug Fixes

- Fixed DateTimeConverter issue where a white space string would return a - DateTime.MinValue instead of null.

### 1.1.0

#### Features

- Changed .NET 3.5 project to client profile.
- Added getter for the current record in the header.

### 1.0.0

#### Features

- Changed strict mode to default to true.
- Renamed strict mode configuration property.
- Changed reader to not throw an exception when there are duplicate header records unless in strict mode.

#### Bug Fixes

- Fixed bug where if there is no line ending at the end of the file, the last field would be null instead of an empty string.
- Fixed configuration references and constructor signatures.

### 0.16.0

#### Features

- Added configuration option for using CultureInvariant to read/write.
- Updated the reader/writer to use the config option.
- Both CsvReader and CsvWriter are using Local culture when converting from/to strings.
- CsvClassMap without generic argument.

### 0.15.0

#### Features

- Changed TryGetField<T> to do a low level check instead of jsut wrapping in try/catch blocks.
- Removed non generic TryGetField methods.
- Formatting changes.
- Changed CsvParser to use the Configuration.Comment char instead of #.

#### Bug Fixes

- Fixed indentation error caused by new constructor in CsvPropertyMap.

### 0.14.0

#### Features

- Changed GetRecords<T> to return IEnumerable<T>.
- Added convenience constructor to CsvPropertyMap.
- Major configuration overhaul.
- Changed end of file check to be more low level.
- Final record is returned if there is a trailing delimiter.
- Added an exception re-throw to parsing that tells the line and character number.
- Added ability to change what the quote char is.
- Added CSV specific exceptions.

#### Bug Fixes

- Fix for issue when CsvHelper uses CurrentCulture instead of InvariantCulture.

### 0.13.0

#### Features

- Changed StreamReader to TextReader to be more generic.

### 0.12.0

#### Features

- Added option to have a commented out line using '#' as the first character of the line.

#### Bug Fixes

- Fixed issue with spaces in non-quoted field.