使用 system.text.json 时,若枚举名称无法识别(如大小写不匹配或包含特殊字符),应配置 jsonserializeroptions 的 propertynamecaseinsensitive 为 true,并设置 converters 添加 jsonstringenumconverter。这样序列化器会忽略大小写差异,并将枚举值转换为字符串进行解析,从而避免抛出异常。

JsonSerializer.Deserialize 遇到大小写不匹配的枚举字段会返回什么
当 JSON 中的枚举字段名与 C# 属性名大小写不一致时,默认情况下 JsonSerializer 会因找不到匹配的属性而跳过该字段,导致反序列化后的对象中该枚举属性保持为默认零值。通过启用 PropertyNameCaseInsensitive 选项,可以强制匹配逻辑忽略大小写,从而正确填充枚举值。

using System;
using System.Text.Json;
using System.Text.Json.Serialization;
public enum Status { Active, Inactive }
public class Item {
public string Name { get; set; }
public Status Status { get; set; }
}
class Program {
static void Main() {
var options = new JsonSerializerOptions {
PropertyNameCaseInsensitive = true,
Converters = { new JsonStringEnumConverter() }
};
// 输入JSON中枚举值为字符串且大小写不同
string json = "{\"name\":\"Test\",\"status\":\"ACTIVE\"}";
var item = JsonSerializer.Deserialize<item>(json, options);
Console.WriteLine(item.Status); // 输出: Active
}
}</item>
自定义 JsonConverter 如何处理非标准枚举格式
如果枚举名称包含连字符、空格等不符合 C# 标识符规范的字符,或者需要支持特定的别名映射,默认的转换器可能无法直接处理。此时可以通过继承 JsonConverter 实现自定义转换逻辑,在 Read 方法中将输入的字符串映射到对应的枚举成员,或在 Write 方法中输出特定格式的字符串。
将包含oralBroadcastingList、materialList、bgmInfo等字段的JSON视频素材转换为剪映API可用的自然语言描述,用于生成视频制作指令,包括素材匹配、时间轴计算、字幕同步、特殊效果处理等。

using System;
using System.Text.Json;
using System.Text.Json.Serialization;
public enum Priority { High, Low }
public class PriorityConverter : JsonConverter<priority> {
public override Priority Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) {
string value = reader.GetString();
if (value == "Urgent") return Priority.High;
if (value == "Normal") return Priority.Low;
throw new JsonException("Unknown priority");
}
public override void Write(Utf8JsonWriter writer, Priority value, JsonSerializerOptions options) {
switch (value) {
case Priority.High: writer.WriteStringValue("Urgent"); break;
case Priority.Low: writer.WriteStringValue("Normal"); break;
}
}
}
public class Task {
[JsonConverter(typeof(PriorityConverter))]
public Priority Priority { get; set; }
}
class Program {
static void Main() {
var options = new JsonSerializerOptions();
string json = "{\"priority\":\"Urgent\"}";
var task = JsonSerializer.Deserialize<task>(json, options);
Console.WriteLine(task.Priority); // 输出: High
}
}</task></priority>
基于程序中 JsonStringEnumConverter 的 AllowIntegerValues 属性的具体行为
在 JsonStringEnumConverter 中,AllowIntegerValues 属性默认为 true。这意味着即使配置了字符串转换,如果 JSON 中输入的是整数(如 0 或 1),转换器仍会将其视为有效的枚举值并进行转换。若设置为 false,则仅接受字符串形式的枚举名称,输入整数将引发 JsonException。










