CsvHelper

Starting from version 27, all delegate argument objects have had their init accessors removed. You must now use constructor parameters to initialize these objects instead of object initializers.

Common examples include:

• BadDataFoundArgs
• ConvertFromStringArgs
• ConvertToStringArgs
• GetConstructorArgs
• GetDynamicPropertyNameArgs
• HeaderValidatedArgs
• MissingFieldFoundArgs
• PrepareHeaderForMatchArgs
• ReadingExceptionOccurredArgs
• ReferenceHeaderPrefixArgs
• ShouldQuoteArgs
• ShouldSkipRecordArgs
• ShouldUseConstructorParametersArgs
• ValidateArgs

The ConfigurationFunctions.ShouldSkipRecord helper has been removed in version 28. If you want to disable skipping records or use the default behavior, you can now assign null to the ShouldSkipRecord property in your CsvConfiguration.

var config = new CsvConfiguration(CultureInfo.InvariantCulture)
{
	ShouldSkipRecord = null
};

When migrating from version 29 to version 30, the ValidateArgs constructor signature has changed. You must now include the row in addition to the field.

// 29
var args = new ValidateArgs(field);

// 30
var args = new ValidateArgs(field, row);

In version 23 and later, all constructor parameters for CsvConfiguration have been removed. You must now use property setters to configure options. For example, instead of passing a delimiter to the constructor, set the Delimiter property on the instance.

// v23 and later
var config = new CsvConfiguration(CultureInfo.InvariantCulture)
{
	Delimiter = ";",
};

In version 29, the boolean property CsvConfiguration.SanitizeForInjection was replaced by the InjectionOptions enum property CsvConfiguration.InjectionOptions. If you were previously setting SanitizeForInjection = true, you should now use InjectionOptions.Escape to achieve similar behavior.

// Version 28 style
var config = new CsvConfiguration(CultureInfo.InvariantCulture)
{
    SanitizeForInjection = true,
}

// Version 29 style
var config = new CsvConfiguration(CultureInfo.InvariantCulture)
{
    InjectionOptions = InjectionOptions.Escape,
}

In version 22, the ShouldQuote delegate signature in CsvConfiguration was updated to include the row index. The new signature is (field, context, row) => bool.

// v22
var config = new CsvConfiguration(CultureInfo.InvariantCulture)
{
	ShouldQuote = (field, context, row) => true,
};

Starting with version 22, EnumConverter is case-sensitive by default. To allow enums to ignore case during mapping, use the EnumIgnoreCase() type converter option.

Map(m => m.Property).TypeConverterOption.EnumIgnoreCase();

Version 33.1.0 includes performance improvements and updated framework support:

• Performance: Uses Attributes.IsDefined for type attribute checks and includes an early exit in ObjectCreator when no arguments are present to reduce allocations.
• Framework Support: Removed support for net6.0 and net7.0. Added support for net9.0.
• Bug Fixes: Added Dispose and DisposeAsync to writer async methods. Fixed an issue where UseDefaultOnConversionFailure failed when the default value was null.

In version 27 and later, the tab character (\t) was removed from the default WhiteSpaceChars array. If your application requires tab characters to be treated as whitespace for trimming, you must explicitly include them in the WhiteSpaceChars configuration.

var config = new CsvConfiguration(CultureInfo.InvariantCulture)
{
	WhiteSpaceChars = new[] { ' ', '\t' },
};

You can install CsvHelper using either the NuGet Package Manager Console or the .NET CLI.

### Package Manager Console
```powershell
PM> Install-Package CsvHelper

.NET CLI Console

> dotnet add package CsvHelper