IXmlSerializable.ReadXml(XmlReader) 方法

定义

从其 XML 表示形式生成对象。

C#
public void ReadXml(System.Xml.XmlReader reader);

参数

reader
XmlReader

从中对对象进行反序列化的 XmlReader 流。

示例

下面的示例演示 了 方法的 ReadXml 实现。

C#
public void ReadXml (XmlReader reader)
{
    personName = reader.ReadString();
}

下面的示例演示如何使用 XmlSerializer 类来反序列化此对象。

C#
using System;
using System.IO;
using System.Xml.Serialization;

public class Reader {

  public static void Main() {
    XmlSerializer serializer = new XmlSerializer(typeof(Person));
    FileStream file = new FileStream("test.xml", FileMode.Open);
    Person aPerson = (Person) serializer.Deserialize(file);
    Console.WriteLine(aPerson);
  }
}

注解

方法 ReadXml 必须使用 方法写入 WriteXml 的信息重新构造对象。

调用此方法时,读取器位于包装类型信息的开始标记上。 也就是说,直接在开始标记上指示序列化对象的开头。 此方法返回时,必须从头到尾读取整个元素,包括其所有内容。 WriteXml与 方法不同,框架不会自动处理包装元素。 实现必须执行此操作。 未能遵守这些定位规则可能会导致代码生成意外的运行时异常或损坏数据。

实现此方法时,应考虑恶意用户可能提供格式正常但无效的 XML 表示形式,以禁用或以其他方式更改应用程序的行为。

适用于

产品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0