XmlSerializer.Deserializeとは？ わかりやすく解説

.NET Framework クラス ライブラリ リファレンス
索引トップ 用語の索引 ランキング
日本マイクロソフト株式会社日本マイクロソフト株式会社

XmlSerializer.Deserialize メソッド (XmlReader, String)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定した XmlReader に格納されている XML ドキュメントを、指定したエンコーディング スタイルを使用して逆シリアル化します。

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

Visual Basic (宣言)
Public Function Deserialize ( _
    xmlReader As XmlReader, _
    encodingStyle As String _
) As Object
Visual Basic (使用法)
Dim instance As XmlSerializer
Dim xmlReader As XmlReader
Dim encodingStyle As String
Dim returnValue As Object

returnValue = instance.Deserialize(xmlReader, encodingStyle)
C#
public Object Deserialize (
    XmlReader xmlReader,
    string encodingStyle
)
C++
public:
Object^ Deserialize (
    XmlReader^ xmlReader, 
    String^ encodingStyle
)
J#
public Object Deserialize (
    XmlReader xmlReader, 
    String encodingStyle
)
JScript
public function Deserialize (
    xmlReader : XmlReader, 
    encodingStyle : String
) : Object

パラメータ

xmlReader

逆シリアル化する XML ドキュメントを格納している XmlReader。

encodingStyle

シリアル化された XML のエンコーディング スタイル。

戻り値
逆シリアル化されたオブジェクト。

例外例外
例外の種類条件

InvalidOperationException

逆シリアル化中にエラーが発生しました。元の例外には、InnerException プロパティを使用してアクセスできます。

解説解説

逆シリアル化とは、XML ドキュメントのインスタンスを読み取り、そのドキュメントの XML スキーマ (XSD) に厳密に型指定されたオブジェクトを構築する処理のことです。

逆シリアル化する前に、逆シリアル化の対象オブジェクトの型を使用して XmlSerializer を生成する必要があります。

SOAP Version 1.1 エンコーディングを使用する場合は、encodingStyle パラメータを "http://schemas.xmlsoap.org/soap/encoding/" に設定します。それ以外の場合は、SOAP Version 1.2 エンコーディングを使用する "http://www.w3.org/2001/12/soap-encoding" に設定します。

メモ   次のような ArrayList の配列および List の配列については、XmlSerializer で逆シリアル化することはできません。

プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
XmlSerializer クラス
XmlSerializer メンバ
System.Xml.Serialization 名前空間
XmlAttributes クラス
CanDeserialize
Serialize
その他の技術情報
XML シリアル化の概要
方法 : XML ストリームの代替要素名を指定する
属性を使用した XML シリアル化の制御
XML シリアル化の例
XML スキーマ定義ツール (Xsd.exe)

XmlSerializer.Deserialize メソッド (Stream)

指定した Stream に格納されている XML ドキュメントを逆シリアル化します。

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

Visual Basic (宣言)
Public Function Deserialize ( _
    stream As Stream _
) As Object
Visual Basic (使用法)
Dim instance As XmlSerializer
Dim stream As Stream
Dim returnValue As Object

returnValue = instance.Deserialize(stream)
C#
public Object Deserialize (
    Stream stream
)
C++
public:
Object^ Deserialize (
    Stream^ stream
)
J#
public Object Deserialize (
    Stream stream
)
JScript
public function Deserialize (
    stream : Stream
) : Object

パラメータ

stream

逆シリアル化する XML ドキュメントを格納している Stream。

戻り値
逆シリアル化される Object。

解説解説

逆シリアル化とは、XML ドキュメントを読み取り、そのドキュメントの XML スキーマ (XSD) に厳密に型指定されたオブジェクトを構築する処理のことです。

逆シリアル化する前に、逆シリアル化の対象オブジェクトの型を使用して XmlSerializer を生成する必要があります。

stream パラメータを使用して、ストリームに書き込むようにデザインされている、Stream クラスから派生したオブジェクトを指定します。Stream の派生クラスには、次のクラスが含まれます。

  • BufferedStream

  • FileStream

  • MemoryStream

  • NetworkStream

  • CryptoStream

メモ   次のような ArrayList の配列および List の配列については、XmlSerializer で逆シリアル化することはできません。

使用例使用例

Stream オブジェクトを使用して、オブジェクトを逆シリアル化する例を次に示します。

Visual Basic
Imports System
Imports System.IO
Imports System.Xml.Serialization
Imports Microsoft.VisualBasic


' This is the class that will be deserialized.
Public Class OrderedItem
    <XmlElement(Namespace := "http://www.cpandl.com")>
 _
    Public ItemName As String

    <XmlElement(Namespace := "http://www.cpandl.com")>
 _
    Public Description As String
    
    <XmlElement(Namespace := "http://www.cohowinery.com")>
 _
    Public UnitPrice As Decimal
    
    <XmlElement(Namespace := "http://www.cpandl.com")>
 _
    Public Quantity As Integer
    
    <XmlElement(Namespace := "http://www.cohowinery.com")>
 _
    Public LineTotal As Decimal
    
    'A custom method used to calculate price per item.
    Public Sub Calculate()
        LineTotal = UnitPrice * Quantity
    End Sub
End Class

Public Class Test
    
    Public Shared Sub Main()
        Dim t As New Test()
        ' Read a purchase order.
        t.DeserializeObject("simple.xml")
    End Sub
        
    Private Sub DeserializeObject(ByVal
 filename As String)
        Console.WriteLine("Reading with Stream")
        ' Create an instance of the XmlSerializer.
        Dim serializer As New
 XmlSerializer(GetType(OrderedItem))
        ' Reading the XML document requires a FileStream.
        Dim reader As New
 FileStream(filename, FileMode.Open)
        
        ' Declare an object variable of the type to be deserialized.
        Dim i As OrderedItem
        
        ' Call the Deserialize method to restore the object's state.
        i = CType(serializer.Deserialize(reader), OrderedItem)
        
        ' Write out the properties of the object.
        Console.Write(i.ItemName & ControlChars.Tab & _
                      i.Description & ControlChars.Tab & _
                      i.UnitPrice & ControlChars.Tab & _
                      i.Quantity & ControlChars.Tab & _
                      i.LineTotal)
    End Sub
End Class
C#
using System;
using System.IO;
using System.Xml.Serialization;

// This is the class that will be deserialized.
public class OrderedItem
{
   [XmlElement(Namespace = "http://www.cpandl.com")]
   public string ItemName;
   [XmlElement(Namespace = "http://www.cpandl.com")]
   public string Description;
   [XmlElement(Namespace="http://www.cohowinery.com")]
   public decimal UnitPrice;
   [XmlElement(Namespace = "http://www.cpandl.com")]
   public int Quantity;
   [XmlElement(Namespace="http://www.cohowinery.com")]
   public decimal LineTotal;
   // A custom method used to calculate price per item.
   public void Calculate()
   {
      LineTotal = UnitPrice * Quantity;
   }
}
 
public class Test
{
   public static void Main()
   {
      Test t = new Test();
      // Read a purchase order.
      t.DeserializeObject("simple.xml");
   }

   private void DeserializeObject(string
 filename)
   {   
      Console.WriteLine("Reading with Stream");
      // Create an instance of the XmlSerializer.
      XmlSerializer serializer = 
      new XmlSerializer(typeof(OrderedItem));
      // Reading the XML document requires a FileStream.
      Stream reader= new FileStream(filename,FileMode.Open);
          
      // Declare an object variable of the type to be deserialized.
      OrderedItem i;

      // Call the Deserialize method to restore the object's state.
      i = (OrderedItem) serializer.Deserialize(reader);

      // Write out the properties of the object.
      Console.Write(
      i.ItemName + "\t" +
      i.Description + "\t" +
      i.UnitPrice + "\t" +
      i.Quantity + "\t" +
      i.LineTotal);
   }
}
C++
#using <System.Xml.dll>
#using <System.dll>

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

// This is the class that will be deserialized.
public ref class OrderedItem
{
public:

   [XmlElement(Namespace="http://www.cpandl.com")]
   String^ ItemName;

   [XmlElement(Namespace="http://www.cpandl.com")]
   String^ Description;

   [XmlElement(Namespace="http://www.cohowinery.com")]
   Decimal UnitPrice;

   [XmlElement(Namespace="http://www.cpandl.com")]
   int Quantity;

   [XmlElement(Namespace="http://www.cohowinery.com")]
   Decimal LineTotal;

   // A custom method used to calculate price per item.
   void Calculate()
   {
      LineTotal = UnitPrice * Quantity;
   }
};

void DeserializeObject( String^ filename )
{
   Console::WriteLine( "Reading with Stream" );

   // Create an instance of the XmlSerializer.
   XmlSerializer^ serializer = gcnew XmlSerializer( OrderedItem::typeid );

   // Reading the XML document requires a FileStream.
   Stream^ reader = gcnew FileStream( filename,FileMode::Open );

   // Declare an object variable of the type to be deserialized.
   OrderedItem^ i;

   // Call the Deserialize method to restore the object's state.
   i = dynamic_cast<OrderedItem^>(serializer->Deserialize( reader ));

   // Write out the properties of the object.
   Console::Write( "{0}\t{1}\t{2}\t{3}\t{4}", i->ItemName, i->Description,
 i->UnitPrice, i->Quantity, i->LineTotal );
}

int main()
{
   // Read a purchase order.
   DeserializeObject( "simple.xml" );
}
J#
import System.*;
import System.IO.*;
import System.Xml.Serialization.*;

// This is the class that will be deserialized.
public class OrderedItem
{
    /** @attribute XmlElement(Namespace = "http://www.cpandl.com")
     */
    public String itemName;
    /** @attribute XmlElement(Namespace = "http://www.cpandl.com")
     */
    public String description;
    /** @attribute XmlElement(Namespace = "http://www.cohowinery.com")
     */
    public System.Decimal unitPrice;
    /** @attribute XmlElement(Namespace = "http://www.cpandl.com")
     */
    public int quantity;
    /** @attribute XmlElement(Namespace = "http://www.cohowinery.com")
     */
    public System.Decimal lineTotal;

    // A custom method used to calculate price per item.
    public void Calculate()
    {
        lineTotal = Decimal.Multiply(unitPrice, Convert.ToDecimal(quantity));
    } //Calculate
} //OrderedItem

public class Test
{
    public static void main(String[]
 args)
    {
        Test t = new Test();
        // Read a purchase order.
        t.DeserializeObject("simple.xml");
    } //main

    private void DeserializeObject(String fileName)
    {
        Console.WriteLine("Reading with Stream");

        // Create an instance of the XmlSerializer.
        XmlSerializer serializer =
            new XmlSerializer(OrderedItem.class.ToType());

        // Reading the XML document requires a FileStream.
        Stream reader = new FileStream(fileName, FileMode.Open);

        // Declare an object variable of the type to be deserialized.
        OrderedItem i;

        // Call the Deserialize method to restore the object's state.
        i = (OrderedItem)serializer.Deserialize(reader);

        // Write out the properties of the object.
        Console.Write(i.itemName + "\t" + i.description + "\t"
 + i.unitPrice
            + "\t" + i.quantity + "\t" + i.lineTotal);
    } //DeserializeObject
} //Test

<?xml version="1.0"?>
 <OrderedItem xmlns:inventory="http://www.cpandl.com"
 xmlns:money="http://www.cohowinery.com">
   <inventory:ItemName>Widget</inventory:ItemName>
   <inventory:Description>Regular
 Widget</inventory:Description>
   <money:UnitPrice>2.3</money:UnitPrice>
   <inventory:Quantity>10</inventory:Quantity>
   <money:LineTotal>23</money:LineTotal>
 </OrderedItem>
プラットフォームプラットフォーム

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
参照参照
関連項目
XmlSerializer クラス
XmlSerializer メンバ
System.Xml.Serialization 名前空間
XmlAttributes クラス
CanDeserialize
Serialize
その他の技術情報
XML シリアル化の概要
方法 : XML ストリームの代替要素名を指定する
属性を使用した XML シリアル化の制御
XML シリアル化の例
XML スキーマ定義ツール (Xsd.exe)

XmlSerializer.Deserialize メソッド (TextReader)

指定した TextReader に格納されている XML ドキュメントを逆シリアル化します。

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

Visual Basic (宣言)
Public Function Deserialize ( _
    textReader As TextReader _
) As Object
Visual Basic (使用法)
Dim instance As XmlSerializer
Dim textReader As TextReader
Dim returnValue As Object

returnValue = instance.Deserialize(textReader)
C#
public Object Deserialize (
    TextReader textReader
)
C++
public:
Object^ Deserialize (
    TextReader^ textReader
)
J#
public Object Deserialize (
    TextReader textReader
)
JScript
public function Deserialize (
    textReader : TextReader
) : Object

パラメータ

textReader

逆シリアル化する XML ドキュメントを格納している TextReader。

戻り値
逆シリアル化される Object。

例外例外
例外の種類条件

InvalidOperationException

逆シリアル化中にエラーが発生しました。元の例外には、InnerException プロパティを使用してアクセスできます。

解説解説

逆シリアル化とは、XML ドキュメントのインスタンスを読み取り、そのドキュメントの XML スキーマ (XSD) に厳密に型指定されたオブジェクトを構築する処理のことです。

逆シリアル化する前に、逆シリアル化の対象オブジェクトの型を使用して XmlSerializer を生成する必要があります。

TextReader の継承クラスには、StringReader と StreamReader があります。StreamReader を使用してオブジェクトを逆シリアル化する場合には、適切な Encoding で StreamReader を構築する必要があります。XML ドキュメントで指定されているエンコーディングは無視されます。

メモメモ

XML ドキュメントで指定されたエンコーディングを使用するには、代わりに、XmlReader を受け取る Deserialize オーバーロードを使用します。XmlReader は、XML ドキュメントで指定されたエンコーディングを自動的に検出して使用します。

メモメモ

次のような ArrayList の配列および List の配列については、XmlSerializer で逆シリアル化することはできません。

使用例使用例

TextReader オブジェクトを使用して、オブジェクトを逆シリアル化する例を次に示します。

Visual Basic
Imports System
Imports System.IO
Imports System.Text
Imports System.Xml.Serialization
Imports Microsoft.VisualBasic

' This is the class that will be deserialized.
Public Class OrderedItem
    <XmlElement(Namespace := "http://www.cpandl.com")>
 _
    Public ItemName As String

    <XmlElement(Namespace := "http://www.cpandl.com")>
 _
    Public Description As String
    
    <XmlElement(Namespace := "http://www.cohowinery.com")>
 _
    Public UnitPrice As Decimal
    
    <XmlElement(Namespace := "http://www.cpandl.com")>
 _
    Public Quantity As Integer
    
    <XmlElement(Namespace := "http://www.cohowinery.com")>
 _
    Public LineTotal As Decimal
    ' A custom method used to calculate price per item.
    Public Sub Calculate()
        LineTotal = UnitPrice * Quantity
    End Sub
End Class
Public Class Test
    
    Public Shared Sub Main()
        Dim t As New Test()
        ' Read a purchase order.
        t.DeserializeObject("simple.xml")
    End Sub
    
    Private Sub DeserializeObject(filename
 As String)
        Console.WriteLine("Reading with TextReader")
        
        ' Create an instance of the XmlSerializer specifying type.
        Dim serializer As New
 XmlSerializer(GetType(OrderedItem))
        
        ' Create a TextReader to read the file. 
        Dim fs as New FileStream(filename,
 FileMode.OpenOrCreate)
        Dim reader As New
 StreamReader(fs)
        
        ' Declare an object variable of the type to be deserialized.
        Dim i As OrderedItem
        
        ' Use the Deserialize method to restore the object's state.
        i = CType(serializer.Deserialize(reader), OrderedItem)
        
        ' Write out the properties of the object.
        Console.Write(i.ItemName & ControlChars.Tab & _
                      i.Description & ControlChars.Tab & _
                      i.UnitPrice & ControlChars.Tab & _
                      i.Quantity & ControlChars.Tab & _
                      i.LineTotal)
    End Sub
End Class
C#
using System;
using System.IO;
using System.Text;
using System.Xml.Serialization;

// This is the class that will be deserialized.
public class OrderedItem
{
    [XmlElement(Namespace = "http://www.cpandl.com")]
    public string ItemName;
    [XmlElement(Namespace = "http://www.cpandl.com")]
    public string Description;
    [XmlElement(Namespace = "http://www.cohowinery.com")]
    public decimal UnitPrice;
    [XmlElement(Namespace = "http://www.cpandl.com")]
    public int Quantity;
    [XmlElement(Namespace = "http://www.cohowinery.com")]
    public decimal LineTotal;
    // A custom method used to calculate price per item.
    public void Calculate()
    {
        LineTotal = UnitPrice * Quantity;
    }
}
 
public class Test
{
   public static void Main()
   {
      Test t = new Test();
      // Read a purchase order.
      t.DeserializeObject("simple.xml");
   }
   private void DeserializeObject(string
 filename)
   {   
      Console.WriteLine("Reading with TextReader");

      // Create an instance of the XmlSerializer specifying type.
      XmlSerializer serializer = 
      new XmlSerializer(typeof(OrderedItem));

      // Create a TextReader to read the file. 
      FileStream fs = new FileStream(filename, FileMode.OpenOrCreate);
      TextReader reader = new StreamReader(fs);
      
      // Declare an object variable of the type to be deserialized.
      OrderedItem i;

      // Use the Deserialize method to restore the object's state.
      i = (OrderedItem) serializer.Deserialize(reader);

      // Write out the properties of the object.
      Console.Write(
      i.ItemName + "\t" +
      i.Description + "\t" +
      i.UnitPrice + "\t" +
      i.Quantity + "\t" +
      i.LineTotal);
   }
}
C++
#using <System.Xml.dll>
#using <System.dll>

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

// This is the class that will be deserialized.
public ref class OrderedItem
{
public:
   String^ ItemName;
   String^ Description;
   Decimal UnitPrice;
   int Quantity;
   Decimal LineTotal;

   // A custom method used to calculate price per item.
   void Calculate()
   {
      LineTotal = UnitPrice * Quantity;
   }
};

void DeserializeObject( String^ filename )
{
   Console::WriteLine( "Reading with TextReader" );

   // Create an instance of the XmlSerializer specifying type.
   XmlSerializer^ serializer = gcnew XmlSerializer( OrderedItem::typeid );

   /* Create a TextReader to read the file. Specify an
      Encoding to use. */
   TextReader^ reader = gcnew StreamReader( filename,Encoding::Unicode );

   // Declare an object variable of the type to be deserialized.
   OrderedItem^ i;

   // Use the Deserialize method to restore the object's state.
   i = dynamic_cast<OrderedItem^>(serializer->Deserialize( reader ));

   // Write out the properties of the object.
   Console::Write( "{0}\t{1}\t{2}\t{3}\t{4}", i->ItemName, i->Description,
 i->UnitPrice, i->Quantity, i->LineTotal );
}

int main()
{
   // Read a purchase order.
   DeserializeObject( "simple.xml" );
}
J#
import System.*;
import System.IO.*;
import System.Text.*;
import System.Xml.Serialization.*;

// This is the class that will be deserialized.
public class OrderedItem
{
    public String itemName;
    public String description;
    public System.Decimal unitPrice;
    public int quantity;
    public System.Decimal lineTotal;

    // A custom method used to calculate price per item.
    public void Calculate()
    {
        lineTotal = Decimal.Multiply(unitPrice, Convert.ToDecimal(quantity));
    } //Calculate
} //OrderedItem

public class Test
{
    public static void main(String[]
 args)
    {
        Test t = new Test();
        // Read a purchase order.
        t.DeserializeObject("simple.xml");
    } //main

    private void DeserializeObject(String fileName)
    {
        Console.WriteLine("Reading with TextReader");

        // Create an instance of the XmlSerializer specifying type.
        XmlSerializer serializer =
            new XmlSerializer(OrderedItem.class.ToType());

        /* Create a TextReader to read the file. Specify an
           Encoding to use. */
        TextReader reader = new StreamReader(fileName, Encoding.get_Unicode());

        // Declare an object variable of the type to be deserialized.
        OrderedItem i;

        // Use the Deserialize method to restore the object's state.
        i = (OrderedItem)serializer.Deserialize(reader);

        // Write out the properties of the object.
        Console.Write(i.itemName + "\t" + i.description + "\t"
 + i.unitPrice
            + "\t" + i.quantity + "\t" + i.lineTotal);
    } //DeserializeObject
} //Test
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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
参照参照
関連項目
XmlSerializer クラス
XmlSerializer メンバ
System.Xml.Serialization 名前空間
XmlAttributes クラス
CanDeserialize
Serialize
その他の技術情報
XML シリアル化の概要
方法 : XML ストリームの代替要素名を指定する
属性を使用した XML シリアル化の制御
XML シリアル化の例
XML スキーマ定義ツール (Xsd.exe)

XmlSerializer.Deserialize メソッド (XmlReader, String, XmlDeserializationEvents)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

このメソッドは、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

指定した XmlReader に格納されているデータを使用してオブジェクトを逆シリアル化します。

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

Visual Basic (宣言)
Public Function Deserialize ( _
    xmlReader As XmlReader, _
    encodingStyle As String, _
    events As XmlDeserializationEvents _
) As Object
Visual Basic (使用法)
Dim instance As XmlSerializer
Dim xmlReader As XmlReader
Dim encodingStyle As String
Dim events As XmlDeserializationEvents
Dim returnValue As Object

returnValue = instance.Deserialize(xmlReader, encodingStyle, events)
C#
public Object Deserialize (
    XmlReader xmlReader,
    string encodingStyle,
    XmlDeserializationEvents events
)
C++
public:
Object^ Deserialize (
    XmlReader^ xmlReader, 
    String^ encodingStyle, 
    XmlDeserializationEvents events
)
J#
public Object Deserialize (
    XmlReader xmlReader, 
    String encodingStyle, 
    XmlDeserializationEvents events
)
JScript
public function Deserialize (
    xmlReader : XmlReader, 
    encodingStyle : String, 
    events : XmlDeserializationEvents
) : Object

パラメータ

xmlReader

ドキュメントの読み取りに使用される XmlReader クラスのインスタンス。

encodingStyle

使用されるエンコーディング。

events

XmlDeserializationEvents クラスのインスタンス。

戻り値
逆シリアル化されているオブジェクト。

解説解説

このメソッドは、不明なヘッダーの逆シリアル化に必要です。該当するのは Web サービスの場合だけです。このメソッドを使用して、Web サービス メソッドでのイベントの同期を回避できます。

プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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
参照参照
関連項目
XmlSerializer クラス
XmlSerializer メンバ
System.Xml.Serialization 名前空間

XmlSerializer.Deserialize メソッド

XML ドキュメントを逆シリアル化します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
XmlSerializer.Deserialize (Stream) 指定した Stream に格納されている XML ドキュメントを逆シリアル化します。

.NET Compact Framework によってサポートされています。

XmlSerializer.Deserialize (TextReader) 指定した TextReader に格納されている XML ドキュメントを逆シリアル化します。

.NET Compact Framework によってサポートされています。

XmlSerializer.Deserialize (XmlReader) 指定した XmlReader に格納されている XML ドキュメントを逆シリアル化します。

.NET Compact Framework によってサポートされています。

XmlSerializer.Deserialize (XmlSerializationReader) 指定した XmlSerializationReader に格納されている XML ドキュメントを逆シリアル化します。
XmlSerializer.Deserialize (XmlReader, String) 指定した XmlReader に格納されている XML ドキュメントを、指定したエンコーディング スタイルを使用して逆シリアル化します。

.NET Compact Framework によってサポートされています。

XmlSerializer.Deserialize (XmlReader, XmlDeserializationEvents) 指定した XmlReader に格納されている XML ドキュメントを逆シリアル化します。また、逆シリアル化で発生するイベントのオーバーライドを可能にします。
XmlSerializer.Deserialize (XmlReader, String, XmlDeserializationEvents) 指定した XmlReader に格納されているデータを使用してオブジェクトを逆シリアル化します。
参照参照

関連項目

XmlSerializer クラス
XmlSerializer メンバ
System.Xml.Serialization 名前空間
XmlAttributes クラス
CanDeserialize
Serialize

その他の技術情報

XML シリアル化の概要
方法 : XML ストリームの代替要素名を指定する
属性を使用した XML シリアル化の制御
XML シリアル化の例
XML スキーマ定義ツール (Xsd.exe)

XmlSerializer.Deserialize メソッド (XmlReader)

指定した XmlReader に格納されている XML ドキュメントを逆シリアル化します。

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

Visual Basic (宣言)
Public Function Deserialize ( _
    xmlReader As XmlReader _
) As Object
Visual Basic (使用法)
Dim instance As XmlSerializer
Dim xmlReader As XmlReader
Dim returnValue As Object

returnValue = instance.Deserialize(xmlReader)
C#
public Object Deserialize (
    XmlReader xmlReader
)
C++
public:
Object^ Deserialize (
    XmlReader^ xmlReader
)
J#
public Object Deserialize (
    XmlReader xmlReader
)
JScript
public function Deserialize (
    xmlReader : XmlReader
) : Object

パラメータ

xmlReader

逆シリアル化する XML ドキュメントを格納している XmlReader。

戻り値
逆シリアル化される Object。

例外例外
例外の種類条件

InvalidOperationException

逆シリアル化中にエラーが発生しました。元の例外には、InnerException プロパティを使用してアクセスできます。

解説解説

逆シリアル化とは、XML ドキュメントのインスタンスを読み取り、そのドキュメントの XML スキーマ (XSD) に厳密に型指定されたオブジェクトを構築する処理のことです。

逆シリアル化する前に、逆シリアル化の対象オブジェクトの型を使用して XmlSerializer を生成する必要があります。

XmlReader は、XML ドキュメントで指定されたエンコーディングを自動的に検出して使用します。

メモ   次のような ArrayList の配列および List の配列については、XmlSerializer で逆シリアル化することはできません。

使用例使用例

XmlReader を使用して、オブジェクトを逆シリアル化する例を次に示します。

Visual Basic
Imports System
Imports System.IO
Imports System.Text
Imports System.Xml
Imports System.Xml.Serialization
Imports Microsoft.VisualBasic


' This is the class that will be deserialized.
Public Class OrderedItem
    Public ItemName As String
    Public Description As String
    Public UnitPrice As Decimal
    Public Quantity As Integer
    Public LineTotal As Decimal
        
    ' A custom method used to calculate price per item.
    Public Sub Calculate()
        LineTotal = UnitPrice * Quantity
    End Sub
End Class

Public Class Test
    
    Public Shared Sub Main()
        Dim t As New Test()
        ' Read a purchase order.
        t.DeserializeObject("simple.xml")
    End Sub
      
    Private Sub DeserializeObject(ByVal
 filename As String)
        Console.WriteLine("Reading with XmlReader")
        
        ' Create an instance of the XmlSerializer specifying type and
 namespace.
        Dim serializer As New
 XmlSerializer(GetType(OrderedItem))
        
        ' A FileStream is needed to read the XML document.
        Dim fs As New FileStream(filename,
 FileMode.Open)
        Dim reader As XmlReader = XmlReader.Create(fs)
        
        ' Declare an object variable of the type to be deserialized.
        Dim i As OrderedItem
        
        ' Use the Deserialize method to restore the object's state.
        i = CType(serializer.Deserialize(reader), OrderedItem)
        fs.Close()

        ' Write out the properties of the object.
        Console.Write(i.ItemName & ControlChars.Tab & _
                      i.Description & ControlChars.Tab & _
                      i.UnitPrice & ControlChars.Tab & _
                      i.Quantity & ControlChars.Tab & _
                      i.LineTotal)
    End Sub
End Class
C#
using System;
using System.IO;
using System.Text;
using System.Xml;
using System.Xml.Serialization;

// This is the class that will be deserialized.
public class OrderedItem
{
    public string ItemName;
    public string Description;
    public decimal UnitPrice;
    public int Quantity;
    public decimal LineTotal;

    // A custom method used to calculate price per item.
    public void Calculate()
    {
        LineTotal = UnitPrice * Quantity;
    }
}
public class Test
{
    public static void Main(string[]
 args)
    {
        Test t = new Test();
        // Read a purchase order.
        t.DeserializeObject("simple.xml");
    }

    private void DeserializeObject(string
 filename)
    {
        Console.WriteLine("Reading with XmlReader");

        // Create an instance of the XmlSerializer specifying type and
 namespace.
        XmlSerializer serializer = new
        XmlSerializer(typeof(OrderedItem));

        // A FileStream is needed to read the XML document.
        FileStream fs = new FileStream(filename, FileMode.Open);
        XmlReader reader = XmlReader.Create(fs);

        // Declare an object variable of the type to be deserialized.
        OrderedItem i;

        // Use the Deserialize method to restore the object's state.
        i = (OrderedItem)serializer.Deserialize(reader);
        fs.Close();

        // Write out the properties of the object.
        Console.Write(
        i.ItemName + "\t" +
        i.Description + "\t" +
        i.UnitPrice + "\t" +
        i.Quantity + "\t" +
        i.LineTotal);
    }
}
C++
#using <System.Xml.dll>
#using <System.dll>

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

// This is the class that will be deserialized.
public ref class OrderedItem
{
public:
   String^ ItemName;
   String^ Description;
   Decimal UnitPrice;
   int Quantity;
   Decimal LineTotal;

   // A custom method used to calculate price per item.
   void Calculate()
   {
      LineTotal = UnitPrice * Quantity;
   }
};

void DeserializeObject( String^ filename )
{
   Console::WriteLine( "Reading with XmlReader" );

   // Create an instance of the XmlSerializer specifying type and namespace.
   XmlSerializer^ serializer = gcnew XmlSerializer( OrderedItem::typeid );

   // A FileStream is needed to read the XML document.
   FileStream^ fs = gcnew FileStream( filename,FileMode::Open );
   XmlReader^ reader = gcnew XmlTextReader( fs );

   // Declare an object variable of the type to be deserialized.
   OrderedItem^ i;

   // Use the Deserialize method to restore the object's state.
   i = dynamic_cast<OrderedItem^>(serializer->Deserialize( reader ));

   // Write out the properties of the object.
   Console::Write( "{0}\t{1}\t{2}\t{3}\t{4}", i->ItemName, i->Description,
 i->UnitPrice, i->Quantity, i->LineTotal );
}

int main()
{
   // Read a purchase order.
   DeserializeObject( "simple.xml" );
}
J#
import System.*;
import System.IO.*;
import System.Text.*;
import System.Xml.*;
import System.Xml.Serialization.*;

// This is the class that will be deserialized.
public class OrderedItem
{
    public String itemName;
    public String description;
    public System.Decimal unitPrice;
    public int quantity;
    public System.Decimal lineTotal;

    // A custom method used to calculate price per item.
    public void Calculate()
    {
        lineTotal = Decimal.Multiply(unitPrice, Convert.ToDecimal(quantity));
    } //Calculate
} //OrderedItem

public class Test
{
    public static void main(String[]
 args)
    {
        Test t = new Test();
        // Read a purchase order.
        t.DeserializeObject("simple.xml");
    } //main

    private void DeserializeObject(String fileName)
    {
        Console.WriteLine("Reading with XmlReader");

        // Create an instance of the XmlSerializer specifying type and
 namespace.
        XmlSerializer serializer =
            new XmlSerializer(OrderedItem.class.ToType());

        // A FileStream is needed to read the XML document.
        FileStream fs = new FileStream(fileName, FileMode.Open);
        XmlReader reader = new XmlTextReader(fs);

        // Declare an object variable of the type to be deserialized.
        OrderedItem i;

        // Use the Deserialize method to restore the object's state.
        i = (OrderedItem)serializer.Deserialize(reader);

        // Write out the properties of the object.
        Console.Write(i.itemName + "\t" + i.description + "\t"
 + i.unitPrice
            + "\t" + i.quantity + "\t" + i.lineTotal);
    } //DeserializeObject
} //Test

<?xml version="1.0"?>
 <OrderedItem xmlns:inventory="http://www.cpandl.com"
 xmlns:money="http://www.cohowinery.com">
   <inventory:ItemName>Widget</inventory:ItemName>
   <inventory:Description>Regular
 Widget</inventory:Description>
   <money:UnitPrice>2.3</money:UnitPrice>
   <inventory:Quantity>10</inventory:Quantity>
   <money:LineTotal>23</money:LineTotal>
 </OrderedItem>
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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
参照参照
関連項目
XmlSerializer クラス
XmlSerializer メンバ
System.Xml.Serialization 名前空間
XmlAttributes クラス
CanDeserialize
Serialize
その他の技術情報
XML シリアル化の概要
方法 : XML ストリームの代替要素名を指定する
属性を使用した XML シリアル化の制御
XML シリアル化の例
XML スキーマ定義ツール (Xsd.exe)

XmlSerializer.Deserialize メソッド (XmlReader, XmlDeserializationEvents)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定した XmlReader に格納されている XML ドキュメントを逆シリアル化します。また、逆シリアル化で発生するイベントのオーバーライドを可能にします。

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

Visual Basic (宣言)
Public Function Deserialize ( _
    xmlReader As XmlReader, _
    events As XmlDeserializationEvents _
) As Object
Visual Basic (使用法)
Dim instance As XmlSerializer
Dim xmlReader As XmlReader
Dim events As XmlDeserializationEvents
Dim returnValue As Object

returnValue = instance.Deserialize(xmlReader, events)
C#
public Object Deserialize (
    XmlReader xmlReader,
    XmlDeserializationEvents events
)
C++
public:
Object^ Deserialize (
    XmlReader^ xmlReader, 
    XmlDeserializationEvents events
)
J#
public Object Deserialize (
    XmlReader xmlReader, 
    XmlDeserializationEvents events
)
JScript
public function Deserialize (
    xmlReader : XmlReader, 
    events : XmlDeserializationEvents
) : Object

パラメータ

xmlReader

逆シリアル化するドキュメントを格納している XmlReader。

events

XmlDeserializationEvents クラスのインスタンス。

戻り値
逆シリアル化される Object。

解説解説

逆シリアル化されているオブジェクト。

プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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
参照参照
関連項目
XmlSerializer クラス
XmlSerializer メンバ
System.Xml.Serialization 名前空間

XmlSerializer.Deserialize メソッド (XmlSerializationReader)

このメソッドは、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

指定した XmlSerializationReader に格納されている XML ドキュメントを逆シリアル化します。

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

Visual Basic (宣言)
Protected Overridable Function
 Deserialize ( _
    reader As XmlSerializationReader _
) As Object
Visual Basic (使用法)
Dim reader As XmlSerializationReader
Dim returnValue As Object

returnValue = Me.Deserialize(reader)
C#
protected virtual Object Deserialize (
    XmlSerializationReader reader
)
C++
protected:
virtual Object^ Deserialize (
    XmlSerializationReader^ reader
)
J#
protected Object Deserialize (
    XmlSerializationReader reader
)
JScript
protected function Deserialize (
    reader : XmlSerializationReader
) : Object

パラメータ

reader

逆シリアル化する XML ドキュメントを格納している XmlSerializationReader。

戻り値
逆シリアル化されたオブジェクト。

例外例外
例外の種類条件

NotImplementedException

メソッドが派生クラスでオーバーライドされない場合は、そのメソッドへのアクセスが行われます。

プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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
参照参照
関連項目
XmlSerializer クラス
XmlSerializer メンバ
System.Xml.Serialization 名前空間

英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

カテゴリ一覧

全て

＋ ビジネス

＋ 業界用語

＋ コンピュータ

＋ 電車

＋ 自動車・バイク

＋ 船

＋ 工学

＋ 建築・不動産

＋ 学問

＋ 文化

＋ 生活

＋ ヘルスケア

＋ 趣味

＋ スポーツ

＋ 生物

＋ 食品

＋ 人名

＋ 方言

＋ 辞書・百科事典

すべての辞書の索引

あいうえお
かきくけこ
さしすせそ
たちつてと
なにぬねの
はひふへほ
まみむめも
やゆよ
らりるれろ
わをん
がぎぐげご
ざじずぜぞ
だぢづでど
ばびぶべぼ
ぱぴぷぺぽ
ＡＢＣＤＥ
ＦＧＨＩＪ
ＫＬＭＮＯ
ＰＱＲＳＴ
ＵＶＷＸＹ
Ｚ
１２３４５
６７８９０
記号

Weblioのサービス

「XmlSerializer.Deserialize」の関連用語

1
XmlSerializer.Deserialize メソッド
.NET Framework クラス ライブラリ リファレンス
100% |||||

XmlSerializer.Deserializeのお隣キーワード

XmlSerializationWriter メンバ

XmlSerializationWriter.WriteXmlAttribute メソッド

XmlSerializationWriter.WriteXsiType メソッド

XmlSerializer.CanDeserialize メソッド

XmlSerializer.CreateReader メソッド

XmlSerializer.CreateWriter メソッド

XmlSerializer.Deserialize

XmlSerializer.Deserialize メソッド

XmlSerializer.FromMappings メソッド

XmlSerializer.FromTypes メソッド

XmlSerializer.GenerateSerializer メソッド

XmlSerializerAssemblyAttribute クラス

XmlSerializerAssemblyAttribute コンストラクタ

検索ランキング

   

 英語⇒日本語
日本語⇒英語		    


XmlSerializer.Deserializeのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS