CsvHelper怎么用-创新互联
这篇文章主要介绍了CsvHelper怎么用，具有一定借鉴价值，感兴趣的朋友可以参考下，希望大家阅读完这篇文章之后大有收获，下面让小编带着大家一起了解一下。
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 value csv.Configuration.AllowComments = false;
自动映射
var generatedMap = csv.Configuration.AutoMap();
缓存
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;
忽略读取异常
读取发生异常之后仍继续读取
// 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(); csv.Configuration.RegisterClassMap ();
跳过空白记录
如果所有字段都是空的，就会被认为是空字段
// 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(); // 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 );
}感谢你能够认真阅读完这篇文章，希望小编分享的“CsvHelper怎么用”这篇文章对大家有帮助，同时也希望大家多多支持创新互联成都网站设计公司，关注创新互联成都网站设计公司行业资讯频道，更多相关知识等着你来学习!
另外有需要云服务器可以了解下创新互联scvps.cn，海内外云服务器15元起步，三天无理由+7*72小时售后在线，公司持有idc许可证，提供“云服务器、裸金属服务器、网站设计器、香港服务器、美国服务器、虚拟主机、免备案服务器”等云主机租用服务以及企业上云的综合解决方案，具有“安全稳定、简单易用、服务可用性高、性价比高”等特点与优势，专为企业上云打造定制，能够满足用户丰富、多元化的应用场景需求。
网页名称：CsvHelper怎么用-创新互联
URL链接：http://azwzsj.com/article/dsopgh.html
