Ezfx.Csv 2.2.8

CSV2Entity

Install

Install Core from Nuget

• CSV2Entity

Instial Visual Studio Extension from marketplace

https://marketplace.visualstudio.com/items?itemName=EricZhou.int123

To view the introduce Video please visit:

https://youtu.be/z3eB05DaQuI

What is CSV

CSV is the abbreviation of Comma-separated values, a file format stores tabular data in plain-text form, usually with .csv extension. CSV is a simple file format that is widely supported by consumer, business, and scientific applications.

Examples

Example of a USA/UK CSV file

Year,Make,Model,Length

1997,Ford,E350,2.34

2000,Mercury,Cougar,2.38

CSV Entity

In order to build CSV entities, we need something more. Csharp’s Attribute Mechanism provides us what we need by decorate CSV class properties with a custom attribute. Custom attribute defines CVS field’s display name and order. Here is the CsvFieldAttribute:

public class CsvFieldAttribute:Attribute

{

   public string Name { get; set; }

   public int Order { get; set; }

}

With CsvFieldAttribute, now we can decorate our own class.

public class Car

{

   [CsvField(Name = "Year", Order = 0)]

   public string Year { get; set; }

   [CsvField(Name = "Make", Order = 1)]

   public string Make { get; set; }

   [CsvField(Name = "Model", Order = 2)]

   public string Model { get; set; }

   [CsvField(Name = "Length", Order = 3)]

   public string Length { get; set; }

}

Generate CSV Class

So, do we need to create CSV classes manually? Of cause not. So I developed the following tool to generate CSV classes:

To Generate CSV Classes, you have to install the VSIX file:

After the installation a new template called EZFX CSV Class will be displayed in your Visual Studio 2010 both in language VB and C#.

Add VB Class:

Add C# Class:

After click of add, a CSV Generate Wizard Window will be displayed, you can select a CSV file by click the browse button, this Wizard support Excel(xls, xlsx) and Access files(mdb, accdb), too. You specify the encoding for the CSV file and table name for Excel and Access file.

The following is the generated file:

The C# file:

The VB code:

Imports Ezfx.Csv

<CsvObject(CodePage:=65001, Description:="", HasHeader:=True, MappingType:=Ezfx.Csv.CsvMappingType.Title, Name:="", Delimiter:=",")> _
Public Class Csv1

    ''' <summary>
    ''' 0, file_format
    ''' </summary>
    <SystemCsvColumn(Alias:="", Ordinal:=0, Name:="file_format")> _
    Public Property file_format() As String


    ''' <summary>
    ''' 1, languages
    ''' </summary>
    <SystemCsvColumn(Alias:="", Ordinal:=1, Name:="languages")> _
    Public Property languages() As String


    ''' <summary>
    ''' 2, no
    ''' </summary>
    <SystemCsvColumn(Alias:="", Ordinal:=2, Name:="no")> _
    Public Property no() As String


    ''' <summary>
    ''' 3, publish_time
    ''' </summary>
    <SystemCsvColumn(Alias:="", Ordinal:=3, Name:="publish_time")> _
    Public Property publish_time() As String


    ''' <summary>
    ''' 4, source
    ''' </summary>
    <SystemCsvColumn(Alias:="", Ordinal:=4, Name:="source")> _
    Public Property source() As String


    ''' <summary>
    ''' 5, srt_page_url
    ''' </summary>
    <SystemCsvColumn(Alias:="", Ordinal:=5, Name:="srt_page_url")> _
    Public Property srt_page_url() As String


    ''' <summary>
    ''' 6, title
    ''' </summary>
    <SystemCsvColumn(Alias:="", Ordinal:=6, Name:="title")> _
    Public Property title() As String


    ''' <summary>
    ''' 7, title_en
    ''' </summary>
    <SystemCsvColumn(Alias:="", Ordinal:=7, Name:="title_en")> _
    Public Property title_en() As String


    ''' <summary>
    ''' 8, tv_movie
    ''' </summary>
    <SystemCsvColumn(Alias:="", Ordinal:=8, Name:="tv_movie")> _
    Public Property tv_movie() As String


    ''' <summary>
    ''' 9, version
    ''' </summary>
    <SystemCsvColumn(Alias:="", Ordinal:=9, Name:="version")> _
    Public Property version() As String




End Class

This is a .Net 3.5 Version of VB file. For the 4.0 Version, the get and set body can be omitted. I will add this feature in the coming version.

CSV Read

The following code reads a csv file and put data to Csv Objects.

ImdbCsv[] imdbs = CsvContext.ReadFile<ImdbCsv>("imdb.csv");

You can also provide csv content as a string

ImdbCsv[] imdbs = CsvContext.ReadContext<ImdbCsv>("...");

Document Generator

With Document Generator, you can get the schema of the CSV files or the Excel and Access files and save the result to a CSV file for further edit.

References

CSV in Wikipedia: http://en.wikipedia.org/wiki/Comma-separated_values