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