定石4:カスタムJsonConverter —業務固有型の専用変換

// ✅定石4:金額用カスタムJsonConverter（書き出し時に円マーク付与など）
public class MoneyJsonConverter : JsonConverter<decimal>
{
    public override void WriteJson(JsonWriter writer, decimal value, JsonSerializer serializer)
    {
        writer.WriteValue(value);  //数値で書き出し（業務系では文字列化しない方が後段が楽）
    }
 
    public override decimal ReadJson(JsonReader reader, Type objectType,
        decimal existingValue, bool hasExistingValue, JsonSerializer serializer)
    {
        //数値・文字列どちらでも受けられるように寛容実装
        if (reader.TokenType == JsonToken.Integer || reader.TokenType == JsonToken.Float)
            return Convert.ToDecimal(reader.Value);
 
        if (reader.TokenType == JsonToken.String)
            return decimal.Parse((string)reader.Value);
 
        throw new JsonSerializationException($"Unexpected token type: {reader.TokenType}");
    }
}
 
//使い方:クラスのプロパティに [JsonConverter] 属性で適用
public class InvoiceDto
{
    public int InvoiceId { get; set; }
 
    [JsonConverter(typeof(MoneyJsonConverter))]
    public decimal Amount { get; set; }
}