CsvHelper는 CSV 파일을 읽고 쓰기 위한 .NET 라이브러리입니다. CsvHelper는 Visual Studio의 패키지 관리자를 통해 다운로드할 수 있습니다. 자동 매핑 정의: 매핑 파일이 제공되지 않으면 기본값은 자동 매핑이며, 이는 클래스의 속성에 순차적으로 매핑됩니다.
GitHub 주소
var csv = new CsvReader( textReader ); var records = csv.GetRecords<MyClass>(); // 把 CSV 记录映射到 MyClass,返回的 records 是个 IEnumerable<T> 对象
매핑 관계를 맞춤설정하려면 아래 매핑 섹션을 참조하세요.
레코드는 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" ); // 内容转换 } }
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. } ); } }
매핑은 런타임에 생성될 수 있습니다.
Rvar 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);
r맵핑// Default value csv.Configuration.AllowComments = false;로그인 후 복사
var generatedMap = csv.Configuration.AutoMap<MyClass>();
// Default value csv.Configuration.BufferSize = 2048;
// Default value csv.Configuration.Comment = '#';
// Default value csv.Configuration.CountBytes = false;
Separator
// Default value csv.Configuration.CultureInfo = CultureInfo.CurrentCulture;
활성화하면 열 번호가 변경되면 CsvBadDataException이 발생합니다.
// Default value csv.Configuration.Delimiter = ",";
// 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 )];
이 문서는 번역되었습니다 by tang yi ke jun
// Default value csv.Configuration.PropertyBindingFlags = BindingFlags.Public | BindingFlags.Instance;
모든 필드가 인용됩니다
// Default value csv.Configuration.Quote = '"';
따옴표가 없는 모든 필드
QuoteAllFields와 QuoteNoFields는 동시에 true일 수 없습니다.
// Default value csv.Configuration.QuoteAllFields = false;
// 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;
// Default value csv.Configuration.TrimFields = false;
Unbind 클래스 맵
// 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;
Exception.Data["CsvHelper"] // Row: '3' (1 based) // Type: 'CsvHelper.Tests.CsvReaderTests+TestBoolean' // Field Index: '0' (0 based) // Field Name: 'BoolColumn' // Field Value: 'two'
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(); }
CSV에 DataTable
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(); } }
jQuery EasyUI API 중국어 문서 - Documentation Documentation_jquery
관련 동영상:위 내용은 CSV 파일에 대한 기술 솔루션을 위한 .NET 라이브러리: CsvHelper 중국어 문서의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!