如何使用FileHelpers在C#中写入动态结构的CSV文件？

嘿，刚好我之前做过类似的需求，用FileHelpers完全不用自己折腾反射那套复杂操作，它本身就提供了简洁的方式来实现动态类型的CSV导出，还能保证类型安全！

核心思路：用DynamicRecord或FieldHelper简化赋值 #

你一开始用DelimitedClassBuilder构建动态类型的方向是对的，接下来创建记录并赋值的时候，FileHelpers已经帮你封装好了类型安全的赋值方法，不用手动遍历属性：

方法1：用DynamicRecord直接赋值（最简便）

DynamicRecord是FileHelpers专门为动态类型设计的包装类，它实现了类似字典的访问方式，既能直接按字段名赋值，又会自动做类型校验：

// 1. 构建动态类
var builder = new DelimitedClassBuilder("DynamicDocument", ";");
builder.AddField("Date", typeof(DateTime));
builder.AddField("Amount", typeof(decimal));
builder.AddField("Description", typeof(string));
var dynamicType = builder.CreateRecordClass();

// 2. 创建并赋值动态记录
var record = new DynamicRecord(dynamicType);
record["Date"] = DateTime.Now;
record["Amount"] = 299.95m;
record["Description"] = "Monthly Subscription";

// 如果赋值类型不匹配，会直接抛出FileHelpersException，保证类型安全
// 比如下面这句会报错：record["Amount"] = "not a number";

方法2：用FieldHelper.SetValue实现类型安全赋值

如果你不想用DynamicRecord，也可以直接创建动态类实例，然后用FieldHelper.SetValue方法赋值——它会自动处理类型转换和验证，比手动反射靠谱多了：

var record = Activator.CreateInstance(dynamicType);
// 直接传对应类型的值
FieldHelper.SetValue(record, "Date", DateTime.Now);
// 甚至可以传字符串，它会自动按字段类型转换（前提是格式合法）
FieldHelper.SetValue(record, "Amount", "299.95");

导出CSV到文件 #

有了记录列表之后，用DelimitedFileEngine就能快速导出CSV：

var engine = new DelimitedFileEngine(dynamicType);
var records = new List<object> { record };
// 导出到文件
engine.WriteFile("output.csv", records);
// 或者导出到流
engine.WriteStream(yourStream, records);

额外优化：给字段加验证/配置 #

如果需要更严格的类型安全或者自定义格式，还能在构建字段的时候添加规则，比如：

// 添加必填字段
var amountField = builder.AddField("Amount", typeof(decimal));
amountField.FieldNotNull = true;
// 设置自定义转换器（比如处理不同的小数分隔符）
amountField.FieldConverter = new DecimalConverter(".");
// 设置字段长度限制
var descField = builder.AddField("Description", typeof(string));
descField.FieldMaxLength = 100;

总结一下 #

完全不需要手动写反射遍历属性的代码，FileHelpers已经把这些细节封装好了：

• 用DelimitedClassBuilder定义用户可配置的字段顺序和类型
• 用DynamicRecord或FieldHelper.SetValue快速创建类型安全的记录
• 用DelimitedFileEngine导出CSV

这样既满足了用户自定义字段的需求，又保证了类型安全，代码还简洁易懂～

内容的提问来源于stack exchange，提问作者Gonzo345