如何让XmlSerializer在遇到XML意外元素时抛出异常？

我手里有一大堆XML文件，但没有对应的XML Schema或者任何说明文档，只能基于特定XML生成C#类。麻烦的是这些文件结构复杂还互相有差异，我想知道XmlSerializer能不能在遇到未定义的意外元素时直接抛出异常？

举个具体的例子：
我的C#类定义是这样的：

[XmlRoot(ElementName = "team")]
public class Team
{
    [XmlElement(ElementName = "player")]
    public List<Player> Players { get; set; }
    [XmlElement(ElementName = "coach")]
    public Coach Coach { get; set; }
}

而对应的XML里出现了一个没定义的元素：

<team>
    <player></player>
    <player></player>
    <coach></coach>
    <unexpectedElement></unexpectedElement>
</team>

这里的<unexpectedElement>没在Team类里定义，我希望这种情况被判定为无效，有没有解决办法？

当然有办法让XmlSerializer对意外元素“零容忍”，下面是几个实用的方案，你可以根据自己的场景选择：

方案1：监听UnknownElement事件手动抛异常 #

XmlSerializer本身会在遇到未定义的元素时触发UnknownElement事件，我们只需要给这个事件绑定处理逻辑，直接抛出异常就行：

var serializer = new XmlSerializer(typeof(Team));
// 绑定未知元素处理事件
serializer.UnknownElement += (sender, e) => 
{
    throw new InvalidOperationException($"发现未定义的XML元素: {e.Element.Name}");
};

// 执行反序列化
using var reader = XmlReader.Create("你的XML文件路径.xml");
var team = (Team)serializer.Deserialize(reader);

这样只要XML里出现类中未定义的元素，反序列化过程就会立即终止并抛出异常，完全符合你的需求。

方案2：实现IXmlSerializable接口完全掌控反序列化 #

如果你的XML结构特别复杂，需要更精细的控制，可以让Team类实现IXmlSerializable接口，自己编写反序列化的每一步逻辑，遇到未知元素直接抛出异常：

[XmlRoot(ElementName = "team")]
public class Team : IXmlSerializable
{
    public List<Player> Players { get; set; } = new List<Player>();
    public Coach Coach { get; set; }

    public XmlSchema GetSchema() => null;

    public void ReadXml(XmlReader reader)
    {
        reader.ReadStartElement("team");
        
        while (reader.NodeType != XmlNodeType.EndElement)
        {
            if (reader.LocalName == "player")
            {
                var playerSerializer = new XmlSerializer(typeof(Player));
                Players.Add((Player)playerSerializer.Deserialize(reader));
            }
            else if (reader.LocalName == "coach")
            {
                var coachSerializer = new XmlSerializer(typeof(Coach));
                Coach = (Coach)coachSerializer.Deserialize(reader);
            }
            else
            {
                // 遇到未知元素直接抛出异常
                throw new InvalidOperationException($"不允许的未知元素: {reader.LocalName}");
            }
        }
        
        reader.ReadEndElement();
    }

    public void WriteXml(XmlWriter writer)
    {
        // 按需实现序列化逻辑即可
        foreach (var player in Players)
        {
            new XmlSerializer(typeof(Player)).Serialize(writer, player);
        }
        if (Coach != null)
        {
            new XmlSerializer(typeof(Coach)).Serialize(writer, Coach);
        }
    }
}

这种方式完全由你掌控反序列化的流程，适合处理结构多变、需要严格校验的XML文件。

方案3：结合XML Schema验证检测未知元素 #

如果你想同时做更多的XML规则校验（比如元素类型、必填项等），可以先从现有C#类生成临时的XML Schema，再用XmlReader的验证功能来检测未知元素：

// 从Team类生成对应的XML Schema
var schemaExporter = new XmlSchemaExporter(new XmlSchemas());
var xmlTypeMapping = new XmlReflectionImporter().ImportTypeMapping(typeof(Team));
schemaExporter.ExportTypeMapping(xmlTypeMapping);
var schema = schemaExporter.Schemas[0];

// 配置XmlReader的验证规则
var settings = new XmlReaderSettings();
settings.Schemas.Add(schema);
settings.ValidationType = ValidationType.Schema;
// 验证出错时抛出异常
settings.ValidationEventHandler += (sender, e) => 
{
    if (e.Severity == XmlSeverityType.Error)
        throw new XmlSchemaValidationException(e.Message);
};

// 带验证的反序列化
using var reader = XmlReader.Create("你的XML文件路径.xml", settings);
var serializer = new XmlSerializer(typeof(Team));
var team = (Team)serializer.Deserialize(reader);

这种方式不仅能检测未知元素，还能帮你验证XML的其他合规性，适合需要全面校验的场景。

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