C#中如何将RequestModel的Consignment属性序列化为数组形式

我懂你现在的烦恼——明明想让consignment序列化成数组格式，但试了Consignment[]和List<Consignment>都碰到了转换问题对吧？咱们来一步步搞定它。

问题根源 #

你原来的RequestModel里，consignment是单个Consignment实例（看起来你用的是字段而非属性？），所以Json.NET序列化时自然会输出对象格式，而不是数组。要得到数组，核心是把这个成员的类型改成集合类型，并且正确初始化。

方案一：直接修改属性类型（推荐） #

把RequestModel里的consignment从单个对象改成List<Consignment>或者Consignment[]，并且初始化时把默认的Consignment实例放进集合里。示例代码如下：

public class Consignment
{
    public object collectionDetails { get; set; } // 你的Consignment类结构
}

public class RequestModel
{
    public string job_id { get; set; }
    // 用List<Consignment>作为属性类型，初始化时包含一个默认实例
    public List<Consignment> consignment { get; set; } = new List<Consignment> { new Consignment() };
}

如果想用数组类型，也可以这么写：

public class RequestModel
{
    public string job_id { get; set; }
    public Consignment[] consignment { get; set; } = new Consignment[] { new Consignment() };
}

这样调用JsonConvert.SerializeObject(new RequestModel())时，就会输出你想要的格式：

{ "job_id": null, "consignment": [ { "collectionDetails": null } ] }

方案二：不修改原有类型，用自定义序列化（适合无法修改类结构的场景） #

如果因为某些限制不能改RequestModel的原有属性类型，可以通过添加一个用于序列化的“影子属性”来实现：

public class RequestModel
{
    public string job_id { get; set; }
    // 保留原有的单个对象字段/属性
    public Consignment consignment = new Consignment();

    // 告诉Json.NET序列化时用这个数组属性代替原字段
    [JsonProperty("consignment")]
    private Consignment[] SerializeConsignment => new[] { consignment };

    // 如果需要反序列化，还要添加对应的处理逻辑
    [JsonIgnore]
    public Consignment Consignment
    {
        get => consignment;
        set => consignment = value;
    }
}

这个方法的好处是不改动原有类的对外结构，但如果需要双向序列化（反序列化JSON到对象），要额外处理反逻辑，所以优先推荐方案一。

常见坑点提醒 #

• 如果你之前试过集合类型但出错，大概率是没有初始化集合或者没把单个实例添加进去——比如只改了类型但没给consignment赋值，导致序列化出空数组；
• 尽量用属性（带get;set;）而非字段，Json.NET对属性的支持更稳定，也符合C#的编码规范。

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