技术解答CSV 文件的一个 .NET 库：CsvHelper 中文文档

时间2024-01-31 00:01:03发布访客分类ASP.NET浏览978

导读：收集整理的这篇文章主要介绍了技术解答CSV 文件的一个 .NET 库：CsvHelper 中文文档，觉得挺不错的，现在分享给大家，也给大家做个参考。CsvHelPEr 是读写 CSV 文件的一个 .NET 库。可以通过 Visual Stu...

收集整理的这篇文章主要介绍了技术解答CSV 文件的一个 .NET 库：CsvHelper 中文文档，觉得挺不错的，现在分享给大家，也给大家做个参考。CsvHelPEr 是读写 CSV 文件的一个 .NET 库。可以通过 Visual Studio 的包管理器下载 CsvHelper。自动映射定义：没有提供映射文件的情况下，默认为自动映射，自动映射会按顺序依次映射到类的属性中去。

GITHub 地址

读取

读取所有的记录

VAR csv = new CsvReader( textReader );
    var records = csv.GetRecordsmyClass>
    ();
     // 把 CSV 记录映射到 MyClass，返回的 records 是个 IEnumerableT>
     对象

如果想要自定义映射关系，可以看下面映射一节。@H_512_10@由于 records 是个 IEnumerableT> 对象，因此仅当访问的时候才会返回一个记录，访问一次就返回一个记录。如果想要想列表那样访问，可以作如下处理：

var csv = new CsvReader( textReader );
    var records = csv.GetRecordsMyClass>
    ().ToList();

手动读取记录

可以按行循环读取每一行的数据

var csv = new CsvReader( textReader );
while( csv.Read() ){
        var record = csv.GetRecordMyClass>
    ();
}

读取单独的字段

var csv = new CsvReader( textReader );
while( csv.Read() ){
        var intField = csv.GetFieldint>
    ( 0 );
        var stringField = csv.GetFieldstring>
    ( 1 );
        var boolField = csv.GetFieldbool>
    ( "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 : CsvClassMapMyClass>
{
    public MyClassMap()    {
            Map( m =>
     m.Id );
            Map( m = >
     m.Name );
    }
}

本文由 tangyikejun 翻译

引用映射

如果属性是一个自定义类，对应于CSV文件的多个列，那么可以使用引用映射。

public sealed class PersonMap : CsvClassMapPerson>
{
    public PersonMap()    {
            Map( m =>
     m.Id );
            Map( m =>
     m.Name );
            ReferencesAddressMap>
    ( m =>
     m.Address );
    }
}
    public sealed class AddressMap : CsvClassMapAddress>
{
    public AddressMap()    {
            Map( m =>
     m.Street );
            Map( m =>
     m.City );
            Map( m =>
     m.state );
            Map( m =>
     m.Zip );
    }
}

下标指定

可以通过列下标指定映射

public sealed class MyClassMap : CsvClassMapMyClass>
{
    public MyClassMap()    {
            Map( m =>
     m.Id ).Index( 0 );
            Map( m =>
     m.Name ).Index( 1 );
    }
}

列名指定

也可以通过列名指定映射，这要求csv文件有一个头记录，也就是说第一行记录列名

public sealed class MyClassMap : CsvClassMapMyClass>
{
    public MyClassMap()    {
            Map( m =>
     m.Id ).Name( "The Id Column" );
            Map( m =>
     m.Name ).Name( "The Name Column" );
    }
}

同名处理

public sealed class MyClassMap : CsvClassMapMyClass>
{
    public MyClassMap()    {
            Map( m =>
     m.FirstName ).Name( "Name" ).Nameindex( 0 );
            Map( m =>
     m.LastName ).Name( "Name" ).NameIndex( 1 );
    }
}

默认值

public sealed class MyClassMap : CsvClassMapMyClass>
{
    public override void MyClassMap()    {
            Map( m =>
     m.Id ).Index( 0 ).Default( -1 );
            Map( m =>
     m.Name ).Index( 1 ).Default( "Unknown" );
    }
}

类型转换

public sealed class MyClassMap : CsvClassMapMyClass>
{
    public MyClassMap()    {
            Map( m =>
     m.Id ).Index( 0 ).TypeConverterMyIDConverter>
    ();
    }
}

可选类型转换

默认的转换器会处理大部分的类型转换，但是有时候我们可能需要做一些小的改变，这个时候可以尝试是用可选类型转换。

public sealed class MyClassMap : CsvClassMapMyClass>
{
    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 : CsvClassMapMyClass>
{
    public MyClassMap()    {
            // 常数        Map( m =>
     m.Constant ).ConvertUsing( row =>
     3 );
            // 把两列聚合在一起        Map( m =>
     m.Aggregate ).ConvertUsing( row =>
     row.GetFieldint>
    ( 0 ) + row.GetFieldint>
    ( 1 ) );
            // Collection with a single value.        Map( m =>
     m.names ).ConvertUsing( row =>
     new Liststring>
{
     row.GetFieldstring>
( "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.AutoMapMyClass>
    ();

缓存

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.RegisterClassMapMyClassMap>
    ();
    csv.Configuration.RegisterClassMapAnotherClassMap>
    ();

跳过空白记录

如果所有字段都是空的，就会被认为是空字段

// Default valuecsv.Configuration.SkipEmptyRecords = false;

Trim 字段

把字段内容收尾的空白字符删去。

// Default valuecsv.Configuration.TrimFields = false;

Trim 列名

// Default valuecsv.Configuration.TrimHeaders = false;

解绑类映射

// Unregister single map.csv.Configuration.UnregisterClassMapMyClassMap>
    ();
    // 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