FileHelpers框架下FixedLengthRecords固定长度记录的子类化实现问题

问题核心原因 #

FileHelpers的固定长度解析特性支持继承，如果你给子类也加[FixedLengthRecord]和[FieldFixedLength]注解，框架会将子类新增的字段也纳入行解析的长度计算逻辑，而你的基类已经占满了整行的长度，自然会触发长度不匹配的报错。 #

正确实现方案 #

1. 调整子类注解规则 #

• 不要给子类添加[FixedLengthRecord]特性，避免框架将子类识别为独立的固定长度解析类
• 所有从EmployeeCode35拆分出来的业务属性，不要加[FieldFixedLength]注解，这些属性仅用于业务逻辑，不参与框架的行解析流程

2. 调整基类定义 #

在基类中新增虚的拆分方法，供不同子类重写各自的拆分逻辑：

[FixedLengthRecord(FixedMode.ExactLength)]
public class FixedLengthRecord
{
    [FieldFixedLength(5)] 
    public string RcrdId { get; set;  }
    [FieldFixedLength(19)] 
    public string SystemId { get; set;}
    [FieldFixedLength(5)] 
    public string RecordType { get; set;}
    [FieldFixedLength(35)] 
    public string EmployeeCode35 { get; set;}
    [FieldFixedLength(19)] 
    public string DepartmentCode { get; set;}
    [FieldFixedLength(27)] 
    public string Filler { get; set;}

    // 基类定义虚方法，子类重写实现各自的拆分逻辑
    public virtual void SplitUpFields()
    {
        // 基类默认空实现，不需要拆分的记录类型可以直接用
    }
}

3. 修正子类实现 #

不要加任何FileHelpers相关特性，仅重写拆分方法即可，注意C#中string.Substring()的第二个参数是截取长度，不是结束索引，你之前的示例代码这里存在语法错误：

// 子类不要加FixedLengthRecord特性
public class TestSubClass : FixedLengthRecord
{
    // 拆分出来的字段都是普通属性，不加任何FileHelpers特性
    public string EmployeeCode15 { get; set; }
    public string ActionDate { get; set; }
    public string ActionTime { get; set; }
    public string StaffId { get; set; }
    public string SubFiller { get; set; } // 避免和基类的Filler重名
    
    public override void SplitUpFields()
    {
        EmployeeCode15 = EmployeeCode35.Substring(0,15);
        ActionDate = EmployeeCode35.Substring(15, 6);
        ActionTime = EmployeeCode35.Substring(21, 6);
        StaffId = EmployeeCode35.Substring(27, 7);
        SubFiller = EmployeeCode35.Substring(34, 1);
    }
}

4. 解析流程 #

仅用基类作为FileHelpers的解析类型，解析完成后再按RecordType转换为对应子类，执行拆分逻辑：

// 只用基类做解析，不会触发长度错误
var engine = new FileHelperEngine<FixedLengthRecord>();
var records = engine.ReadFile("你的文件路径");

// 按RecordType转换为对应子类并拆分字段
var processedRecords = new List<object>();
foreach (var record in records)
{
    switch (record.RecordType.Trim())
    {
        case "TEST_TYPE": // 替换为你实际的记录类型值
            var subRecord = new TestSubClass
            {
                // 复制基类所有属性值
                RcrdId = record.RcrdId,
                SystemId = record.SystemId,
                RecordType = record.RecordType,
                EmployeeCode35 = record.EmployeeCode35,
                DepartmentCode = record.DepartmentCode,
                Filler = record.Filler
            };
            subRecord.SplitUpFields();
            processedRecords.Add(subRecord);
            break;
        // 其他记录类型同理扩展
        default:
            processedRecords.Add(record);
            break;
    }
}

可选优化 #

如果觉得手动复制基类属性繁琐，可以通过以下方式简化：

• 给基类添加拷贝构造函数
• 用AutoMapper等对象映射工具完成基类到子类的属性拷贝
• 不需要多态的场景下，也可以直接针对基类写不同RecordType对应的扩展方法拆分字段，无需定义子类

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