csvhelper 是读写 csv 文件的一个 .net 库。可以通过 visual studio 的包管理器下载 csvhelper。自动映射定义：没有提供映射文件的情况下，默认为自动映射，自动映射会按顺序依次映射到类的属性中去。
GitHub 地址
读取
读取所有的记录
var csv = new CsvReader( textReader );var records = csv.GetRecords(); // 把 CSV 记录映射到 MyClass，返回的 records 是个 IEnumerable 对象
如果想要自定义映射关系，可以看下面映射一节。
由于 records 是个 IEnumerable 对象，因此仅当访问的时候才会返回一个记录，访问一次就返回一个记录。如果想要想列表那样访问，可以作如下处理：
var csv = new CsvReader( textReader );var records = csv.GetRecords().ToList();
手动读取记录
可以按行循环读取每一行的数据
var csv = new CsvReader( textReader );while( csv.Read() ){ var record = csv.GetRecord();}
读取单独的字段
var csv = new CsvReader( textReader );while( csv.Read() ){ var intField = csv.GetField( 0 ); var stringField = csv.GetField( 1 ); var boolField = csv.GetField( "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{ public MyClassMap() { Map( m => m.Id ); Map( m = > m.Name ); }}
本文由 tangyikejun 翻译
引用映射
如果属性是一个自定义类，对应于CSV文件的多个列，那么可以使用引用映射。
public sealed class PersonMap : CsvClassMap{ public PersonMap() { Map( m => m.Id ); Map( m => m.Name ); References( m => m.Address ); }}public sealed class AddressMap : CsvClassMap{ public AddressMap() { Map( m => m.Street ); Map( m => m.City ); Map( m => m.State ); Map( m => m.Zip ); }}
下标指定
可以通过列下标指定映射
public sealed class MyClassMap : CsvClassMap{ public MyClassMap() { Map( m => m.Id ).Index( 0 ); Map( m => m.Name ).Index( 1 ); }}
列名指定
也可以通过列名指定映射，这要求csv文件有一个头记录，也就是说第一行记录列名
public sealed class MyClassMap : CsvClassMap{ public MyClassMap() { Map( m => m.Id ).Name( "The Id Column" ); Map( m => m.Name ).Name( "The Name Column" ); }}
同名处理
public sealed class MyClassMap : CsvClassMap{ public MyClassMap() { Map( m => m.FirstName ).Name( "Name" ).NameIndex( 0 ); Map( m => m.LastName ).Name( "Name" ).NameIndex( 1 ); }}
默认值
public sealed class MyClassMap : CsvClassMap{ 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{ public MyClassMap() { Map( m => m.Id ).Index( 0 ).TypeConverter(); }}
可选类型转换
默认的转换器会处理大部分的类型转换，但是有时候我们可能需要做一些小的改变，这个时候可以尝试是用可选类型转换。
public sealed class MyClassMap : CsvClassMap{ 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{ public MyClassMap() { // 常数 Map( m => m.Constant ).ConvertUsing( row => 3 ); // 把两列聚合在一起 Map( m => m.Aggregate ).ConvertUsing( row => row.GetField( 0 ) + row.GetField( 1 ) ); // Collection with a single value. Map( m => m.Names ).ConvertUsing( row => new List{ row.GetField( "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 valuecsv.Configuration.AllowComments = false;
自动映射
var generatedMap = csv.Configuration.AutoMap();
缓存
TextReader 或 TextWriter 中读写的缓存
// Default valuecsv.Configuration.BufferSize = 2048;
注释
被注释掉的那行不会被加载进来
// Default valuecsv.Configuration.Comment = '#';
Byte 计数
记录当前读取了多少 Byte 了，需要设置 Configuration.Encoding 与 CSV 文件一致。这个设置会影响解析的速度。
// Default valuecsv.Configuration.CountBytes = false;
Culture 信息
// Default valuecsv.Configuration.CultureInfo = CultureInfo.CurrentCulture;
分割符
// Default valuecsv.Configuration.Delimiter = ",";
列数变化
如果开启，发现列数变化会抛出 CsvBadDataException
// Default valuecsv.Configuration.DetectColumnCountChanges = false;
编码
// Default valuecsv.Configuration.Encoding = Encoding.UTF8;
是否有头记录
// Default valuecsv.Configuration.HasHeaderRecord = true;
忽略列名空格
是否忽略列名中的空格
// Default valuecsv.Configuration.IgnoreHeaderWhiteSpace = false;
忽略私有访问
读写的时候是否忽略私有访问器
// Default valuecsv.Configuration.IgnorePrivateAccessor = false;
忽略读取异常
读取发生异常之后仍继续读取
// Default valuecsv.Configuration.IgnoreReadingExceptions = false;
忽略引号
不把引号作为转义符
// Default valuecsv.Configuration.IgnoreQuotes = false;
列名是否大小写敏感
// Default valuecsv.Configuration.IsHeaderCaseSensitive = true;
映射访问
可以对自定义的类映射进行访问
var myMap = csv.Configuration.Maps[typeof( MyClass )];
属性绑定标记
用来寻找自定义类的属性
// Default valuecsv.Configuration.PropertyBindingFlags = BindingFlags.Public | BindingFlags.Instance;
本文由 tang yi ke jun 翻译
Quote
定义用来转义包含分隔符，括号或者行尾的转义符
// Default valuecsv.Configuration.Quote = '"';
所有字段加引号
写入csv的时候是否对所有字段加引号。QuoteAllFields 和 QuoteNoFields 不能同时为 true 。
// Default valuecsv.Configuration.QuoteAllFields = false;
所有字段不加引号
QuoteAllFields 和 QuoteNoFields 不能同时为 true 。
// Default valuecsv.Configuration.QuoteNoFields = false;
读取异常的回调
csv.Configuration.ReadingExceptionCallback = ( ex, row ) =>{ // Log the exception and current row information.};
注册类映射
使用了类映射的话，需要进行注册才会被实际使用到。
csv.Configuration.RegisterClassMap();csv.Configuration.RegisterClassMap();
跳过空白记录
如果所有字段都是空的，就会被认为是空字段
// Default valuecsv.Configuration.SkipEmptyRecords = false;
Trim 字段
把字段内容收尾的空白字符删去。
// Default valuecsv.Configuration.TrimFields = false;
Trim 列名
// Default valuecsv.Configuration.TrimHeaders = false;
解绑类映射
// Unregister single map.csv.Configuration.UnregisterClassMap();// Unregister all class maps.csv.Configuration.UnregisterClassMap();
空字段是否抛出异常
// Default valuecsv.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 );}
相关文章：
.net CsvHelper 2.0
jQuery EasyUI API 中文文档 – Documentation 文档_jquery
相关视频：
Ruby中文文档
以上就是技术解答CSV 文件的一个 .NET 库：CsvHelper 中文文档的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1432815.html
微信扫一扫 
支付宝扫一扫 
