技術解答CSV 文件的一個 .NET 函式庫：CsvHelper 中文文檔

CsvHelper 是讀寫 CSV 檔案的一個 .NET 函式庫。可以透過 Visual Studio 的套件管理器下載 CsvHelper。自動映射定義：沒有提供映射檔案的情況下，預設為自動映射，自動映射會依序依序映射到類別的屬性中去。

GitHub 位址

讀取

讀取所有的記錄

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

如果想要自訂映射關係，可以看下面映射一節。
由於 records 是個 IEnumerable8742468051c85b06f0a0af9e3e506b5c 對象，因此僅當訪問的時候才會返回一個記錄，訪問一次就會返回一個記錄。如果想要想列表那樣訪問，可以作如下處理：

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;

忽略讀取異常

讀取發生異常後仍繼續讀取

// 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 );
}

相關文章：

.net CsvHelper 2.0

#jQuery EasyUI API 中文文件 - Documentation 文件_jquery

相關影片：

Ruby中文文件

以上是技術解答CSV 文件的一個 .NET 函式庫：CsvHelper 中文文檔的詳細內容。更多資訊請關注PHP中文網其他相關文章！