csvhelper 是读写 csv 文件的一个 .net 库。可以通过 visual studio 的包管理器下载 csvhelper。自动映射定义：没有提供映射文件的情况下，默认为自动映射，自动映射会按顺序依次映射到类的属性中去。
GitHub 地址
读取
读取所有的记录
var csv = new CsvReader( textReader ); var records = csv.GetRecords<MyClass>(); // 把 CSV 记录映射到 MyClass，返回的 records 是个 IEnumerable<T> 对象
如果想要自定义映射关系，可以看下面映射一节。
由于 records 是个 IEnumerable
var csv = new CsvReader( textReader ); var records = csv.GetRecords<MyClass>().ToList();
手动读取记录
可以按行循环读取每一行的数据
var csv = new CsvReader( textReader );
while( csv.Read() )
{
var record = csv.GetRecord<MyClass>();
}读取单独的字段
var csv = new CsvReader( textReader );
while( csv.Read() )
{
var intField = csv.GetField<int>( 0 );
var stringField = csv.GetField<string>( 1 );
var boolField = csv.GetField<bool>( "HeaderName" );
}如果读取的类型跟预期的可能会不同，那么可以用 TryGetField
var csv = new CsvReader( textReader );
while( csv.Read() )
{
int intField;
if( !csv.TryGetField( 0, out intField ) )
{
// Do something when it can't convert.
}
}解析
想要每一行作为一个字符串返回可以使用 CsvParser 。
var parser = new CsvParser( textReader );
while( true )
{
var row = parser.Read(); // row 是个字符串
if( row == null )
{
break;
}
}写入
写入所有记录
var csv = new CsvWriter( textWriter ); csv.WriteRecords( records );
var csv = new CsvWriter( textWriter );
foreach( var item in list )
{
csv.WriteRecord( item );
}var csv = new CsvWriter( textWriter );
foreach( var item in list )
{
csv.WriteField( "a" );
csv.WriteField( 2 );
csv.WriteField( true );
csv.NextRecord();
}映射
自动映射
没有提供映射文件的情况下，默认为自动映射，自动映射会按顺序依次映射到类的属性中去。如果属性是一个自定义类，那么会继续依次按照这个自定义类的属性进行填入。如果出现了循环引用，那么自动映射会停止。
手动映射
如果 CSV 文件和自定义的类并不是完全的匹配，那么可以定义一个匹配类来处理。
public sealed class MyClassMap : CsvClassMap<MyClass>
{
public MyClassMap()
{
Map( m => m.Id );
Map( m = > m.Name );
}
}本文由 tangyikejun 翻译
引用映射
如果属性是一个自定义类，对应于CSV文件的多个列，那么可以使用引用映射。
public sealed class PersonMap : CsvClassMap<Person>
{
public PersonMap()
{
Map( m => m.Id );
Map( m => m.Name );
References<AddressMap>( m => m.Address );
}
}
public sealed class AddressMap : CsvClassMap<Address>
{
public AddressMap()
{
Map( m => m.Street );
Map( m => m.City );
Map( m => m.State );
Map( m => m.Zip );
}
}下标指定
可以通过列下标指定映射
public sealed class MyClassMap : CsvClassMap<MyClass>
{
public MyClassMap()
{
Map( m => m.Id ).Index( 0 );
Map( m => m.Name ).Index( 1 );
}
}列名指定
也可以通过列名指定映射，这要求csv文件有一个头记录，也就是说第一行记录列名
public sealed class MyClassMap : CsvClassMap<MyClass>
{
public MyClassMap()
{
Map( m => m.Id ).Name( "The Id Column" );
Map( m => m.Name ).Name( "The Name Column" );
}
}同名处理
public sealed class MyClassMap : CsvClassMap<MyClass>
{
public MyClassMap()
{
Map( m => m.FirstName ).Name( "Name" ).NameIndex( 0 );
Map( m => m.LastName ).Name( "Name" ).NameIndex( 1 );
}
}默认值
public sealed class MyClassMap : CsvClassMap<MyClass>
{
public override void MyClassMap()
{
Map( m => m.Id ).Index( 0 ).Default( -1 );
Map( m => m.Name ).Index( 1 ).Default( "Unknown" );
}
}类型转换
public sealed class MyClassMap : CsvClassMap<MyClass>
{
public MyClassMap()
{
Map( m => m.Id ).Index( 0 ).TypeConverter<MyIdConverter>();
}
}可选类型转换
默认的转换器会处理大部分的类型转换，但是有时候我们可能需要做一些小的改变，这个时候可以尝试是用可选类型转换。
public sealed class MyClassMap : CsvClassMap<MyClass>
{
public MyClassMap()
{
Map( m => m.Description ).Index( 0 ).TypeConverterOption( CultureInfo.InvariantCulture ); //
Map( m => m.TimeStamp ).Index( 1 ).TypeConverterOption( DateTimeStyles.AdjustToUniversal ); // 时间格式转换
Map( m => m.Cost ).Index( 2 ).TypeConverterOption( NumberStyles.Currency ); // 数值类型转换
Map( m => m.CurrencyFormat ).Index( 3 ).TypeConverterOption( "C" );
Map( m => m.BooleanValue ).Index( 4 ).TypeConverterOption( true, "sure" ).TypeConverterOption( false, "nope" ); // 内容转换
}
}ConvertUsing
public sealed class MyClassMap : CsvClassMap<MyClass>
{
public MyClassMap()
{
// 常数
Map( m => m.Constant ).ConvertUsing( row => 3 );
// 把两列聚合在一起
Map( m => m.Aggregate ).ConvertUsing( row => row.GetField<int>( 0 ) + row.GetField<int>( 1 ) );
// Collection with a single value.
Map( m => m.Names ).ConvertUsing( row => new List<string>{ row.GetField<string>( "Name" ) } );
// Just about anything.
Map( m => m.Anything ).ConvertUsing( row =>
{
// You can do anything you want in a block.
// Just make sure to return the same type as the property.
} );
}
}运行时映射
可以在运行时创建映射。
var customerMap = new DefaultCsvClassMap();
// mapping holds the Property - csv column mapping
foreach( string key in mapping.Keys )
{
var columnName = mapping[key].ToString();
if( !String.IsNullOrEmpty( columnName ) )
{
var propertyInfo = typeof( Customer ).GetType().GetProperty( key );
var newMap = new CsvPropertyMap( propertyInfo );
newMap.Name( columnName );
customerMap.PropertyMaps.Add( newMap );
}
}
csv.Configuration.RegisterClassMap(CustomerMap);本文由 tangyikejun 翻译
配置
允许注释
// Default value csv.Configuration.AllowComments = false;
自动映射
var generatedMap = csv.Configuration.AutoMap<MyClass>();
缓存
TextReader 或 TextWriter 中读写的缓存
// Default value csv.Configuration.BufferSize = 2048;
注释
被注释掉的那行不会被加载进来
// Default value csv.Configuration.Comment = '#';
Byte 计数
记录当前读取了多少 Byte 了，需要设置 Configuration.Encoding 与 CSV 文件一致。这个设置会影响解析的速度。
// Default value csv.Configuration.CountBytes = false;
Culture 信息
// Default value csv.Configuration.CultureInfo = CultureInfo.CurrentCulture;
分割符
// Default value csv.Configuration.Delimiter = ",";
列数变化
如果开启，发现列数变化会抛出 CsvBadDataException
// Default value csv.Configuration.DetectColumnCountChanges = false;
编码
// Default value csv.Configuration.Encoding = Encoding.UTF8;
是否有头记录
// Default value csv.Configuration.HasHeaderRecord = true;
忽略列名空格
是否忽略列名中的空格
// Default value csv.Configuration.IgnoreHeaderWhiteSpace = false;
忽略私有访问
读写的时候是否忽略私有访问器
// Default value csv.Configuration.IgnorePrivateAccessor = false;
忽略读取异常
读取发生异常之后仍继续读取
华友协同办公自动化OA系统
下载
华友协同办公管理系统(华友OA)，基于微软最新的.net 2.0平台和SQL Server数据库，集成强大的Ajax技术，采用多层分布式架构，实现统一办公平台，功能强大、价格便宜，是适用于企事业单位的通用型网络协同办公系统。 系统秉承协同办公的思想，集成即时通讯、日记管理、通知管理、邮件管理、新闻、考勤管理、短信管理、个人文件柜、日程安排、工作计划、工作日清、通讯录、公文流转、论坛、在线调查、
// Default value csv.Configuration.IgnoreReadingExceptions = false;
忽略引号
不把引号作为转义符
// Default value csv.Configuration.IgnoreQuotes = false;
列名是否大小写敏感
// Default value csv.Configuration.IsHeaderCaseSensitive = true;
映射访问
可以对自定义的类映射进行访问
var myMap = csv.Configuration.Maps[typeof( MyClass )];
属性绑定标记
用来寻找自定义类的属性
// Default value csv.Configuration.PropertyBindingFlags = BindingFlags.Public | BindingFlags.Instance;
本文由 tang yi ke jun 翻译
Quote
定义用来转义包含分隔符，括号或者行尾的转义符
// Default value csv.Configuration.Quote = '"';
所有字段加引号
写入csv的时候是否对所有字段加引号。QuoteAllFields 和 QuoteNoFields 不能同时为 true 。
// Default value csv.Configuration.QuoteAllFields = false;
所有字段不加引号
QuoteAllFields 和 QuoteNoFields 不能同时为 true 。
// Default value csv.Configuration.QuoteNoFields = false;
读取异常的回调
csv.Configuration.ReadingExceptionCallback = ( ex, row ) =>
{
// Log the exception and current row information.
};注册类映射
使用了类映射的话，需要进行注册才会被实际使用到。
csv.Configuration.RegisterClassMap<MyClassMap>(); csv.Configuration.RegisterClassMap<AnotherClassMap>();
跳过空白记录
如果所有字段都是空的，就会被认为是空字段
// Default value csv.Configuration.SkipEmptyRecords = false;
Trim 字段
把字段内容收尾的空白字符删去。
// Default value csv.Configuration.TrimFields = false;
Trim 列名
// Default value csv.Configuration.TrimHeaders = false;
解绑类映射
// Unregister single map. csv.Configuration.UnregisterClassMap<MyClassMap>(); // Unregister all class maps. csv.Configuration.UnregisterClassMap();
空字段是否抛出异常
// Default value csv.Configuration.WillThrowOnMissingField = true;
类型转换
类型转换是 CsvHelper 把字符串转换为 .NET 类型（以及反过来）的方法。
其他
查看异常信息
Exception.Data["CsvHelper"] // Row: '3' (1 based) // Type: 'CsvHelper.Tests.CsvReaderTests+TestBoolean' // Field Index: '0' (0 based) // Field Name: 'BoolColumn' // Field Value: 'two'
DataReader 与 DataTable
DataReader 对象写入到 CSV
var hasHeaderBeenWritten = false;
while( dataReader.Read() )
{
if( !hasHeaderBeenWritten )
{
for( var i = 0; i < dataReader.FieldCount; i++ )
{
csv.WriteField( dataReader.GetName( i ) );
}
csv.NextRecord();
hasHeaderBeenWritten = true;
}
for( var i = 0; i < dataReader.FieldCount; i++ )
{
csv.WriteField( dataReader[i] );
}
csv.NextRecord();
}DataTable 对象写入到 CSV
using( var dt = new DataTable() )
{
dt.Load( dataReader );
foreach( DataColumn column in dt.Columns )
{
csv.WriteField( column.ColumnName );
}
csv.NextRecord();
foreach( DataRow row in dt.Rows )
{
for( var i = 0; i < dt.Columns.Count; i++ )
{
csv.WriteField( row[i] );
}
csv.NextRecord();
}
}CSV 转 DataTable
while( csv.Read() )
{
var row = dt.NewRow();
foreach( DataColumn column in dt.Columns )
{
row[column.ColumnName] = csv.GetField( column.DataType, column.ColumnName );
}
dt.Rows.Add( row );
}相关文章：
jQuery EasyUI API 中文文档 - Documentation 文档_jquery
相关视频：
