FileHelpers v3.1 - 分隔符（CSV）或固定长度数据导入/导出框架

这是您可以提供给默认转换器的参数列表。

ConverterKind.Date

参数 1： 一个字符串，包含引擎传递给 DateTime.Parse 函数的 DateTime 格式。

参数 2： 一个字符串，包含用于字符串转换的编码。

示例

// By default the engines use: "ddMMyyyy"
[FieldConverter(ConverterKind.Date)]
public DateTime ShippedDate;

// Parse these dates:  1-1-2006   01-1-2006   30-01-2006
[FieldConverter(ConverterKind.Date, "d-M-yyyy" )]
public DateTime ShippedDate;

// Parse these dates:  1-1-2006   01-1-2006   01-30-2006
[FieldConverter(ConverterKind.Date, "M-d-yyyy" )]
public DateTime ShippedDate;

// Parse these dates:  01/3/2006   30/02/2006
[FieldConverter(ConverterKind.Date, "d/M/yyyy" )]
public DateTime ShippedDate;

// Parse these dates:  01042006   30022006
[FieldConverter(ConverterKind.Date, "ddMMyyyy" )]
public DateTime ShippedDate;

// Parse these dates:  04/January/2006   02/July/2006
[FieldConverter(ConverterKind.Date, "dd/MMMM/yyyy", "en" )] // or "en-US"
public DateTime ShippedDate;

// Parse these dates:  04/Enero/2006   02/Julio/2006
[FieldConverter(ConverterKind.Date, "dd/MMMM/yyyy", "es" )]
public DateTime ShippedDate;

您可以查看所有支持的格式字符串，请参阅 MSDN 文档中的 DateTime.ParseExact 。
以及 此处所有支持的区域性。

ConverterKind.Double, ConverterKind.Single 和 ConverterKind.Decimal

参数 1： 一个字符串，包含用作小数分隔符的字符。有效值："." 或 ","。 默认： "."

示例

// "." is the decimal separator by default
[FieldConverter(ConverterKind.Double)]
public double Freight;

// "." is the decimal separator. (good for autodocumented code)
[FieldConverter(ConverterKind.Double, ".")]
public double Freight;

// "," is the decimal separator.
[FieldConverter(ConverterKind.Double, ",")]
public double Freight;

// The same for the other converters:
// ConverterKind.Decimal and ConverterKind.Single

整数转换器

ConverterKind.Int16, ConverterKind.Int32, ConverterKind.Int64, ConverterKind.Byte, 
ConverterKind.UInt16, ConverterKind.UInt32, ConverterKind.UInt64, 和 ConverterKind.SByte

参数 1： 一个字符串，包含用作小数分隔符的字符。有效值："." 或 ","。 默认： "."

警告： 该库在此处需要小数分隔符，并在内部创建组分隔符（例如，如果提供 "."，则使用 ","）。

示例

// "." is the decimal separator by default
// allows you to parse:  12,125 or 1,458,385
[FieldConverter(ConverterKind.Int32)]
public Int32 Amount;

// using "," as decimal separator
// allows you to parse:  12.125 or 1.458.385
[FieldConverter(ConverterKind.Int32, ",")]
public Int32 Amount;

// The same works for the rest of the converts

ConverterKind.Boolean

参数 1： 一个字符串，表示 True 值。
参数 2： 一个字符串，表示 False 值。

默认情况下，此转换器将字符串 "True"（不区分大小写）和 "1" 视为 true。将字段转换为字符串时，返回的值为 "True" 和 "False"。

示例

// By default it reads as true the strings "True" (Case insensitive) and "1"
[FieldConverter(ConverterKind.Boolean)]
public bool Shipped;

// Takes as true the string "verdad" and as false the string "mentira" (case insensitive)
[FieldConverter(ConverterKind.Boolean, "Verdad", "MenTiRa")]
public bool Shipped;

// Takes as true the string "1" and as false the string "0"
// You need these params if you want to write, because it use "True" and "False"
[FieldConverter(ConverterKind.Boolean, "1", "0")]
public bool Shipped;

// Takes as true the string "X" and as false the string "-"
[FieldConverter(ConverterKind.Boolean, "X", "-")]
public bool Shipped;