https://github.com/kentcb/kbcsv

KBCsv is an efficient, easy to use .NET parsing and writing library for the CSV (comma-separated values) format.
https://github.com/kentcb/kbcsv

c-sharp csv dotnet library netstandard portable

Last synced: 3 days ago
JSON representation

KBCsv is an efficient, easy to use .NET parsing and writing library for the CSV (comma-separated values) format.

• Host: GitHub
• URL: https://github.com/kentcb/kbcsv
• Owner: kentcb
• License: mit
• Created: 2015-01-08T03:59:20.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2021-03-26T17:17:56.000Z (almost 4 years ago)
• Last Synced: 2025-01-12T12:17:36.903Z (12 days ago)
• Topics: c-sharp, csv, dotnet, library, netstandard, portable
• Language: C#
• Homepage:
• Size: 63.2 MB
• Stars: 78
• Watchers: 12
• Forks: 25
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
![Logo](Art/Logo150x150.png "Logo")

# KBCsv

[![Build status](https://ci.appveyor.com/api/projects/status/0osrhn2736992t52?svg=true)](https://ci.appveyor.com/project/kentcb/kbcsv)

## What?

**KBCsv** is an efficient, easy to use .NET parsing and writing library for the [CSV](http://en.wikipedia.org/wiki/Comma-separated_values) (comma-separated values) format.

## Why?

CSV is a common data format that developers need to work with, and .NET does not include intrinsic support for it. Implementing an efficient, standards-compliant CSV parser is not a trivial task, so using **KBCsv** avoids the need for developers to do so.

## Where?

The easiest way to get **KBCsv** is to install via NuGet:

```

Install-Package KBCsv

```

Or, if you want the extensions:

```

Install-Package KBCsv.Extensions

```

Data-specific extensions are available as a separate package for .NET 4.5 (the other packages above are portable):

```

Install-Package KBCsv.Extensions.Data

```

## How?

```C#

using (var streamReader = new StreamReader("data.csv"))

using (var csvReader = new CsvReader(streamReader))

{

    csvReader.ReadHeaderRecord();

    while (csvReader.HasMoreRecords)

    {

        var record = csvReader.ReadDataRecord();

        var name = record["Name"];

        var age = record["Age"];

    }

}

```

Please see [the documentation](Doc/overview.md) for more details.

## Who?

**KBCsv** is created and maintained by [Kent Boogaart](http://kent-boogaart.com). Issues and pull requests are welcome.

## Primary Features

* Very easy to use

* Very efficient

* Separate extension libraries to provide additional (but optional) features such as working with `System.Data` types

* Portable Class Library targetting netstandard 1.0

* Full `async` support

* Includes extensive documentation and examples in both C# and VB.NET

* Conforms to the official CSV standard, [RFC4180](http://www.ietf.org/rfc/rfc4180.txt)

* Also conforms to pseudo-standards, such as [this](http://www.creativyst.com/Doc/Articles/CSV/CSV01.htm)

* Highly customizable, such as specifying non-standard value separators and delimiters

* Very high test coverage