# kbcsv

**Repository Path**: mirrors_kentcb/kbcsv

## Basic Information

- **Project Name**: kbcsv
- **Description**: KBCsv is an efficient, easy to use .NET parsing and writing library for the CSV (comma-separated values) format.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-02-24
- **Last Updated**: 2025-12-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## 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