XmlSerializer.Deserialize Method

Definition

XML 문서를 역직렬화합니다.Deserializes an XML document.

Overloads

Deserialize(Stream)

지정된 Stream에 포함된 XML 문서를 역직렬화합니다.Deserializes the XML document contained by the specified Stream.

Deserialize(TextReader)

지정된 TextReader에 포함된 XML 문서를 역직렬화합니다.Deserializes the XML document contained by the specified TextReader.

Deserialize(XmlSerializationReader)

지정된 XmlSerializationReader에 포함된 XML 문서를 역직렬화합니다.Deserializes the XML document contained by the specified XmlSerializationReader.

Deserialize(XmlReader)

지정된 XmlReader에 포함된 XML 문서를 역직렬화합니다.Deserializes the XML document contained by the specified XmlReader.

Deserialize(XmlReader, String)

지정된 XmlReader에 포함된 XML 문서와 인코딩 스타일을 역직렬화합니다.Deserializes the XML document contained by the specified XmlReader and encoding style.

Deserialize(XmlReader, XmlDeserializationEvents)

지정된 XmlReader에 포함된 XML 문서를 역직렬화하고 deserialization을 수행하는 동안 발생하는 이벤트를 재정의할 수 있도록 합니다.Deserializes an XML document contained by the specified XmlReader and allows the overriding of events that occur during deserialization.

Deserialize(XmlReader, String, XmlDeserializationEvents)

지정된 XmlReader에 포함된 데이터를 사용하여 개체를 역직렬화합니다.Deserializes the object using the data contained by the specified XmlReader.

Deserialize(Stream)

지정된 Stream에 포함된 XML 문서를 역직렬화합니다.Deserializes the XML document contained by the specified Stream.

public:
 System::Object ^ Deserialize(System::IO::Stream ^ stream);
public object Deserialize (System.IO.Stream stream);
member this.Deserialize : System.IO.Stream -> obj
Public Function Deserialize (stream As Stream) As Object

Parameters

stream
Stream

역직렬화할 XML 문서를 포함하는 Stream입니다.The Stream that contains the XML document to deserialize.

Returns

Object

역직렬화되는 Object입니다.The Object being deserialized.

Examples

다음 예제에서는 Stream 개체를 사용 하 여 개체를 deserialize 합니다.The following example deserializes an object using a Stream object.

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

    // Declare an object variable of the type to be deserialized.
    OrderedItem^ i;
    
    // Reading the XML document requires a FileStream.
    Stream^ reader = gcnew FileStream(filename, FileMode::Open);

    try
    {
        // Call the Deserialize method to restore the object's state.
        i = dynamic_cast<OrderedItem^>(serializer->Deserialize(reader));
    }
    finally
    {
        delete 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" );
}
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));

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

        using (Stream reader = new FileStream(filename, FileMode.Open))
        {
            // 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);
    }
}

Imports System.IO
Imports System.Xml.Serialization

' 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))       
        
        ' Declare an object variable of the type to be deserialized.
        Dim i As OrderedItem

        Using reader As New Filestream(filename, FileMode.Open)

            ' Call the Deserialize method to restore the object's state.
            i = CType(serializer.Deserialize(reader), OrderedItem)
        End Using

        ' 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

<?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>

Remarks

Deserialization은 XML 문서를 읽고 생성 하는 XSD (XML 스키마) 문서의 강력한 형식인 개체의 프로세스입니다.Deserialization is the process of reading an XML document and constructing an object that is strongly typed to the XML Schema (XSD) of the document.

Deserialize 하기 전에 deserialize 되는 개체의 형식을 사용 하 여 XmlSerializer를 생성 해야 합니다.Before deserializing, an XmlSerializer must be constructed using the type of the object that is being deserialized.

stream 매개 변수를 사용 하 여 스트림에 쓰도록 디자인 된 Stream 클래스에서 파생 되는 개체를 지정 합니다.Use the stream parameter to specify an object that derives from the Stream class, which is designed to write to streams. 파생 된 클래스는 Stream 클래스를 포함 합니다.Classes that derive from the Stream class include:

Note

XmlSerializerArrayList 배열과 List<T>배열을 deserialize 할 수 없습니다.The XmlSerializer cannot deserialize the following: arrays of ArrayList and arrays of List<T>.

See also

Deserialize(TextReader)

지정된 TextReader에 포함된 XML 문서를 역직렬화합니다.Deserializes the XML document contained by the specified TextReader.

public:
 System::Object ^ Deserialize(System::IO::TextReader ^ textReader);
public object Deserialize (System.IO.TextReader textReader);
member this.Deserialize : System.IO.TextReader -> obj
Public Function Deserialize (textReader As TextReader) As Object

Parameters

textReader
TextReader

역직렬화할 XML 문서를 포함하는 TextReader입니다.The TextReader that contains the XML document to deserialize.

Returns

Object

역직렬화되는 Object입니다.The Object being deserialized.

Exceptions

역직렬화 하는 동안 오류가 발생 했습니다.An error occurred during deserialization. InnerException 속성을 사용하여 원래 예외를 사용할 수 있습니다.The original exception is available using the InnerException property.

Examples

다음 예제에서는 TextReader 개체를 사용 하 여 개체를 deserialize 합니다.The following example deserializes an object using a TextReader object.

#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" );
}
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);
    }
}
Imports System.IO
Imports System.Text
Imports System.Xml.Serialization

' 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

Remarks

Deserialization은 XML 문서의 인스턴스를 읽고 생성 하는 XSD (XML 스키마) 문서의 강력한 형식인 개체의 프로세스입니다.Deserialization is the process of reading an instance of an XML document and constructing an object that is strongly typed to the XML Schema (XSD) of the document.

Deserialize 하기 전에 deserialize 되는 개체의 형식을 사용 하 여 XmlSerializer를 생성 해야 합니다.Before deserializing, an XmlSerializer must be constructed using the type of the object that is being deserialized.

TextReader에서 상속 되는 클래스에는 StringReaderStreamReader포함 됩니다.Classes that inherit from TextReader include StringReader and StreamReader. StreamReader를 사용 하 여 개체를 deserialize 하는 경우 적절 한 Encoding를 사용 하 여 StreamReader을 생성 해야 합니다.If you are using a StreamReader to deserialize an object, you must construct the StreamReader with an appropriate Encoding. XML 문서에서 지정 된 인코딩은 무시 됩니다.The encoding specified by the XML document is ignored.

Note

XML 문서에 지정 된 인코딩을 사용 하려면 대신 XmlReader를 사용 하는 Deserialize 오버 로드를 사용 합니다.To use the encoding specified by the XML document, use the Deserialize overload that takes an XmlReader instead. XmlReader는 XML 문서에 지정 된 인코딩을 자동으로 검색 하 여 사용 합니다.The XmlReader automatically detects and uses the encoding specified by the XML document.

Note

XmlSerializerArrayList 배열과 List<T>배열을 deserialize 할 수 없습니다.The XmlSerializer cannot deserialize the following: arrays of ArrayList and arrays of List<T>.

See also

Deserialize(XmlSerializationReader)

지정된 XmlSerializationReader에 포함된 XML 문서를 역직렬화합니다.Deserializes the XML document contained by the specified XmlSerializationReader.

protected:
 virtual System::Object ^ Deserialize(System::Xml::Serialization::XmlSerializationReader ^ reader);
protected virtual object Deserialize (System.Xml.Serialization.XmlSerializationReader reader);
abstract member Deserialize : System.Xml.Serialization.XmlSerializationReader -> obj
override this.Deserialize : System.Xml.Serialization.XmlSerializationReader -> obj
Protected Overridable Function Deserialize (reader As XmlSerializationReader) As Object

Parameters

reader
XmlSerializationReader

역직렬화할 XML 문서를 포함하는 XmlSerializationReader입니다.The XmlSerializationReader that contains the XML document to deserialize.

Returns

Object

역직렬화된 개체입니다.The deserialized object.

Exceptions

메서드가 서브 클래스에서 재정의 되지 않았는데 메서드에 액세스 하려고 시도한 모든.Any attempt is made to access the method when the method is not overridden in a descendant class.

Deserialize(XmlReader)

지정된 XmlReader에 포함된 XML 문서를 역직렬화합니다.Deserializes the XML document contained by the specified XmlReader.

public:
 System::Object ^ Deserialize(System::Xml::XmlReader ^ xmlReader);
public object Deserialize (System.Xml.XmlReader xmlReader);
member this.Deserialize : System.Xml.XmlReader -> obj
Public Function Deserialize (xmlReader As XmlReader) As Object

Parameters

xmlReader
XmlReader

역직렬화할 XML 문서를 포함하는 XmlReader입니다.The XmlReader that contains the XML document to deserialize.

Returns

Object

역직렬화되는 Object입니다.The Object being deserialized.

Exceptions

역직렬화 하는 동안 오류가 발생 했습니다.An error occurred during deserialization. InnerException 속성을 사용하여 원래 예외를 사용할 수 있습니다.The original exception is available using the InnerException property.

Examples

다음 예제에서는 XmlReader를 사용 하 여 개체를 deserialize 합니다.The following example deserializes an object using an XmlReader.

#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" );
}
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);
    }
}
Imports System.IO
Imports System.Text
Imports System.Xml
Imports System.Xml.Serialization

' 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

<?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>

Remarks

Deserialization은 XML 문서의 인스턴스를 읽고 생성 하는 XSD (XML 스키마) 문서의 강력한 형식인 개체의 프로세스입니다.Deserialization is the process of reading an instance of an XML document and constructing an object that is strongly typed to the XML Schema (XSD) of the document.

Deserialize 하기 전에 deserialize 되는 개체의 형식을 사용 하 여 XmlSerializer를 생성 해야 합니다.Before deserializing, an XmlSerializer must be constructed using the type of the object that is being deserialized.

XmlReader는 XML 문서에 지정 된 인코딩을 자동으로 검색 하 여 사용 합니다.The XmlReader automatically detects and uses the encoding specified by the XML document.

Note

XmlSerializerArrayList 배열과 List<T>배열을 deserialize 할 수 없습니다.The XmlSerializer cannot deserialize the following: arrays of ArrayList and arrays of List<T>.

See also

Deserialize(XmlReader, String)

지정된 XmlReader에 포함된 XML 문서와 인코딩 스타일을 역직렬화합니다.Deserializes the XML document contained by the specified XmlReader and encoding style.

public:
 System::Object ^ Deserialize(System::Xml::XmlReader ^ xmlReader, System::String ^ encodingStyle);
public object Deserialize (System.Xml.XmlReader xmlReader, string encodingStyle);
member this.Deserialize : System.Xml.XmlReader * string -> obj
Public Function Deserialize (xmlReader As XmlReader, encodingStyle As String) As Object

Parameters

xmlReader
XmlReader

역직렬화할 XML 문서를 포함하는 XmlReader입니다.The XmlReader that contains the XML document to deserialize.

encodingStyle
String

Serialize 된 XML의 인코딩 스타일입니다.The encoding style of the serialized XML.

Returns

Object

역직렬화된 개체입니다.The deserialized object.

Exceptions

역직렬화 하는 동안 오류가 발생 했습니다.An error occurred during deserialization. InnerException 속성을 사용하여 원래 예외를 사용할 수 있습니다.The original exception is available using the InnerException property.

Remarks

Deserialization은 XML 문서의 인스턴스를 읽고 생성 하는 XSD (XML 스키마) 문서의 강력한 형식인 개체의 프로세스입니다.Deserialization is the process of reading an instance of an XML document and constructing an object that is strongly typed to the XML Schema (XSD) of the document.

Deserialize 하기 전에 deserialize 되는 개체의 형식을 사용 하 여 XmlSerializer를 생성 해야 합니다.Before deserializing, an XmlSerializer must be constructed using the type of the object that is being deserialized.

SOAP 버전 1.1 인코딩에 대해 encodingStyle 매개 변수를 "http://schemas.xmlsoap.org/soap/encoding/"로 설정 합니다. 그렇지 않으면 SOAP 버전 1.2 인코딩에 대해 "http://www.w3.org/2001/12/soap-encoding"로 설정 합니다.Set the encodingStyle parameter to "http://schemas.xmlsoap.org/soap/encoding/" for SOAP version 1.1 encoding; otherwise, set it to "http://www.w3.org/2001/12/soap-encoding" for SOAP version 1.2 encoding.

참고 XmlSerializerArrayList 배열과 List<T>배열을 deserialize 할 수 없습니다.Note The XmlSerializer cannot deserialize the following: arrays of ArrayList and arrays of List<T>.

See also

Deserialize(XmlReader, XmlDeserializationEvents)

지정된 XmlReader에 포함된 XML 문서를 역직렬화하고 deserialization을 수행하는 동안 발생하는 이벤트를 재정의할 수 있도록 합니다.Deserializes an XML document contained by the specified XmlReader and allows the overriding of events that occur during deserialization.

public:
 System::Object ^ Deserialize(System::Xml::XmlReader ^ xmlReader, System::Xml::Serialization::XmlDeserializationEvents events);
public object Deserialize (System.Xml.XmlReader xmlReader, System.Xml.Serialization.XmlDeserializationEvents events);
member this.Deserialize : System.Xml.XmlReader * System.Xml.Serialization.XmlDeserializationEvents -> obj
Public Function Deserialize (xmlReader As XmlReader, events As XmlDeserializationEvents) As Object

Parameters

xmlReader
XmlReader

역직렬화할 문서가 포함된 XmlReader입니다.The XmlReader that contains the document to deserialize.

events
XmlDeserializationEvents

XmlDeserializationEvents 클래스의 인스턴스입니다.An instance of the XmlDeserializationEvents class.

Returns

Object

역직렬화되는 Object입니다.The Object being deserialized.

Remarks

역직렬화할 개체입니다.The object being deserialized.

Deserialize(XmlReader, String, XmlDeserializationEvents)

지정된 XmlReader에 포함된 데이터를 사용하여 개체를 역직렬화합니다.Deserializes the object using the data contained by the specified XmlReader.

public:
 System::Object ^ Deserialize(System::Xml::XmlReader ^ xmlReader, System::String ^ encodingStyle, System::Xml::Serialization::XmlDeserializationEvents events);
public object Deserialize (System.Xml.XmlReader xmlReader, string encodingStyle, System.Xml.Serialization.XmlDeserializationEvents events);
member this.Deserialize : System.Xml.XmlReader * string * System.Xml.Serialization.XmlDeserializationEvents -> obj
Public Function Deserialize (xmlReader As XmlReader, encodingStyle As String, events As XmlDeserializationEvents) As Object

Parameters

xmlReader
XmlReader

문서를 읽는 데 사용되는 XmlReader 클래스의 인스턴스입니다.An instance of the XmlReader class used to read the document.

encodingStyle
String

사용 되는 인코딩입니다.The encoding used.

events
XmlDeserializationEvents

XmlDeserializationEvents 클래스의 인스턴스입니다.An instance of the XmlDeserializationEvents class.

Returns

Object

역직렬화할 개체입니다.The object being deserialized.

Remarks

이 메서드는 웹 서비스 시나리오에 대 한 알 수 없는 헤더의 deserialization에 필요 합니다.This method is required for deserialization of unknown headers for Web Service scenarios only. 이 메서드를 사용 하면 웹 서비스 메서드에서 이벤트 동기화를 방지할 수 있습니다.This method allows you to avoid event synchronization in Web Service methods.

Applies to