IXmlSerializable.ReadXml メソッド

.NET Framework クラス ライブラリ リファレンス

IXmlSerializable.ReadXml メソッド

オブジェクトの XML 表現からオブジェクトを生成します。

名前空間: System.Xml.Serialization
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Sub ReadXml ( _
    reader As XmlReader _
)

Visual Basic (使用法)

Dim instance As IXmlSerializable
Dim reader As XmlReader

instance.ReadXml(reader)

C#

void ReadXml (
    XmlReader reader
)

C++

void ReadXml (
    XmlReader^ reader
)

J#

void ReadXml (
    XmlReader reader
)

JScript

function ReadXml (
    reader : XmlReader
)

パラメータ

reader

オブジェクトの逆シリアル化元である XmlReader ストリーム。

解説

ReadXml メソッドは、WriteXml メソッドによって書き込まれた情報を使用して、オブジェクトを再構築する必要があります。

このメソッドが呼び出されると、リーダーは、型の情報をラップする要素の開始位置に配置されます。開始位置とは、シリアル化されたオブジェクトの先頭を示す開始タグの直前のことです。このメソッドから制御が戻ったとき、要素のすべての内容を含め、要素全体が最初から最後まで読み取られていることが必要です。WriteXml メソッドとは異なり、ラッパー要素がフレームワークによって自動的に処理されることはありません。この処理は独自に実装する必要があります。これらの配置規則に従わなかった場合、コードで、予期しないランタイム例外が生成されたり、データが破損する可能性があります。

このメソッドを実装するときは、悪意のあるユーザーが、形式は整っていても無効である XML 表現を用意してアプリケーションの動作を無効にしたり、その他の変更を行ったりする可能性について考慮する必要があります。

使用例

ReadXml メソッドの実装例を次に示します。

C#

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

C++

virtual void ReadXml( XmlReader^ reader )
{
   personName = reader->ReadString();
}

J#

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

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);
  }

}

C++

#using <System.Xml.dll>
#using <System.dll>
#using <Person.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml::Serialization;

int main()
{
   XmlSerializer^ serializer = gcnew XmlSerializer( Person::typeid );
   FileStream^ file = gcnew FileStream( "test.xml",FileMode::Open );
   Person^ aPerson = dynamic_cast<Person^>(serializer->Deserialize( file
 ));
   Console::WriteLine( aPerson );
}

J#

import System.*;
import System.IO.*;
import System.Xml.Serialization.*;
import System.Xml.Schema.* ;
import System.Xml.XmlWriter;
import System.Xml.XmlReader;

public class Reader
{
    public static void main(String[]
 args)
    {
        XmlSerializer serializer = new XmlSerializer(Person.class.ToType());
        FileStream file = new FileStream("test.xml",
 FileMode.Open);
        Person aPerson = (Person)(serializer.Deserialize(file));
        Console.WriteLine(aPerson);
    } //main
} //Reader 

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
IXmlSerializable インターフェイス
IXmlSerializable メンバ
System.Xml.Serialization 名前空間