XmlSerializer.Deserialize Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Deserialisiert ein XML-Dokument.
Überlädt
| Name | Beschreibung |
|---|---|
| Deserialize(Stream) |
Deserialisiert das XML-Dokument, das in dem angegebenen Dokument Streamenthalten ist. |
| Deserialize(TextReader) |
Deserialisiert das XML-Dokument, das in dem angegebenen Dokument TextReaderenthalten ist. |
| Deserialize(XmlSerializationReader) |
Deserialisiert das XML-Dokument, das in dem angegebenen Dokument XmlSerializationReaderenthalten ist. |
| Deserialize(XmlReader) |
Deserialisiert das XML-Dokument, das in dem angegebenen Dokument XmlReaderenthalten ist. |
| Deserialize(XmlReader, String) |
Deserialisiert das XML-Dokument, das in der angegebenen XmlReader und Codierungsformatvorlage enthalten ist. |
| Deserialize(XmlReader, XmlDeserializationEvents) |
Deserialisiert ein XML-Dokument, das in dem angegebenen XmlReader Dokument enthalten ist, und ermöglicht die Außerkraftsetzung von Ereignissen, die während der Deserialisierung auftreten. |
| Deserialize(XmlReader, String, XmlDeserializationEvents) |
Deserialisiert das Objekt mithilfe der daten, die im angegebenen Objekt XmlReaderenthalten sind. |
Deserialize(Stream)
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
Deserialisiert das XML-Dokument, das in dem angegebenen Dokument Streamenthalten ist.
public:
System::Object ^ Deserialize(System::IO::Stream ^ stream);
public object Deserialize(System.IO.Stream stream);
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("XML serializer relies on dynamic code generation which is not available with Ahead of Time compilation")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")]
public object? Deserialize(System.IO.Stream stream);
public object? Deserialize(System.IO.Stream stream);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")]
public object? Deserialize(System.IO.Stream stream);
member this.Deserialize : System.IO.Stream -> obj
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("XML serializer relies on dynamic code generation which is not available with Ahead of Time compilation")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")>]
member this.Deserialize : System.IO.Stream -> obj
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")>]
member this.Deserialize : System.IO.Stream -> obj
Public Function Deserialize (stream As Stream) As Object
Parameter
Gibt zurück
Die Object Deserialisierung.
- Attribute
Beispiele
Im folgenden Beispiel wird ein Objekt mithilfe eines Stream Objekts deserialisiert.
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>
Hinweise
Die Deserialisierung ist der Prozess des Lesens eines XML-Dokuments und das Erstellen eines Objekts, das stark in das XML-Schema (XSD) des Dokuments eingegeben wird.
Vor der Deserialisierung muss ein XmlSerializer Objekt mithilfe des Typs deserialisiert werden.
Verwenden Sie den stream Parameter, um ein Objekt anzugeben, das von der Stream Klasse abgeleitet ist, die zum Schreiben in Datenströme konzipiert ist. Klassen, die von der Stream Klasse abgeleitet werden, umfassen:
Note
Die XmlSerializer folgenden Arrays können nicht deserialisiert werden: Arrays von ArrayList und Arrays von List<T>.
Weitere Informationen
- XmlAttributes
- CanDeserialize(XmlReader)
- Serialize(TextWriter, Object)
- Einführung in die XML-Serialisierung
- Vorgehensweise: Angeben eines alternativen Elementnamens für einen XML-Stream
- Steuern der XML-Serialisierung mithilfe von Attributen
- Beispiele für die XML-Serialisierung
- XML Schema Definition-Tool (Xsd.exe)
Gilt für:
Deserialize(TextReader)
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
Deserialisiert das XML-Dokument, das in dem angegebenen Dokument TextReaderenthalten ist.
public:
System::Object ^ Deserialize(System::IO::TextReader ^ textReader);
public object Deserialize(System.IO.TextReader textReader);
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("XML serializer relies on dynamic code generation which is not available with Ahead of Time compilation")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")]
public object? Deserialize(System.IO.TextReader textReader);
public object? Deserialize(System.IO.TextReader textReader);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")]
public object? Deserialize(System.IO.TextReader textReader);
member this.Deserialize : System.IO.TextReader -> obj
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("XML serializer relies on dynamic code generation which is not available with Ahead of Time compilation")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")>]
member this.Deserialize : System.IO.TextReader -> obj
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")>]
member this.Deserialize : System.IO.TextReader -> obj
Public Function Deserialize (textReader As TextReader) As Object
Parameter
- textReader
- TextReader
Das TextReader XML-Dokument, das deserialisiert werden soll.
Gibt zurück
Die Object Deserialisierung.
- Attribute
Ausnahmen
Fehler bei der Deserialisierung. Die ursprüngliche Ausnahme ist mit der InnerException Eigenschaft verfügbar.
Beispiele
Im folgenden Beispiel wird ein Objekt mithilfe eines TextReader Objekts deserialisiert.
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
Hinweise
Die Deserialisierung ist der Prozess des Lesens einer Instanz eines XML-Dokuments und das Erstellen eines Objekts, das stark in das XML-Schema (XSD) des Dokuments eingegeben ist.
Vor der Deserialisierung muss ein XmlSerializer Objekt mithilfe des Typs deserialisiert werden.
Klassen, die von TextReader include StringReader und StreamReader. Wenn Sie ein StreamReader Objekt zum Deserialisieren eines Objekts verwenden, müssen Sie das StreamReader Objekt mit einem geeigneten EncodingErstellen erstellen. Die vom XML-Dokument angegebene Codierung wird ignoriert.
Note
Um die vom XML-Dokument angegebene Codierung zu verwenden, verwenden Sie stattdessen die Überladung, die Deserialize eine XmlReader Codierung verwendet. Die XmlReader vom XML-Dokument angegebene Codierung wird automatisch erkannt und verwendet.
Note
Die XmlSerializer folgenden Arrays können nicht deserialisiert werden: Arrays von ArrayList und Arrays von List<T>.
Weitere Informationen
- XmlAttributes
- CanDeserialize(XmlReader)
- Serialize(TextWriter, Object)
- Einführung in die XML-Serialisierung
- Vorgehensweise: Angeben eines alternativen Elementnamens für einen XML-Stream
- Steuern der XML-Serialisierung mithilfe von Attributen
- Beispiele für die XML-Serialisierung
- XML Schema Definition-Tool (Xsd.exe)
Gilt für:
Deserialize(XmlSerializationReader)
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
Deserialisiert das XML-Dokument, das in dem angegebenen Dokument XmlSerializationReaderenthalten ist.
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
Parameter
- reader
- XmlSerializationReader
Das XmlSerializationReader XML-Dokument, das deserialisiert werden soll.
Gibt zurück
Das deserialisierte Objekt.
Ausnahmen
Es wird versucht, auf die Methode zuzugreifen, wenn die Methode in einer untergeordneten Klasse nicht überschrieben wird.
Gilt für:
Deserialize(XmlReader)
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
Deserialisiert das XML-Dokument, das in dem angegebenen Dokument XmlReaderenthalten ist.
public:
System::Object ^ Deserialize(System::Xml::XmlReader ^ xmlReader);
public object Deserialize(System.Xml.XmlReader xmlReader);
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("XML serializer relies on dynamic code generation which is not available with Ahead of Time compilation")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")]
public object? Deserialize(System.Xml.XmlReader xmlReader);
public object? Deserialize(System.Xml.XmlReader xmlReader);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")]
public object? Deserialize(System.Xml.XmlReader xmlReader);
member this.Deserialize : System.Xml.XmlReader -> obj
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("XML serializer relies on dynamic code generation which is not available with Ahead of Time compilation")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")>]
member this.Deserialize : System.Xml.XmlReader -> obj
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")>]
member this.Deserialize : System.Xml.XmlReader -> obj
Public Function Deserialize (xmlReader As XmlReader) As Object
Parameter
Gibt zurück
Die Object Deserialisierung.
- Attribute
Ausnahmen
Fehler bei der Deserialisierung. Die ursprüngliche Ausnahme ist mit der InnerException Eigenschaft verfügbar.
Beispiele
Im folgenden Beispiel wird ein Objekt mithilfe eines XmlReaderObjekts deserialisiert.
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>
Hinweise
Die Deserialisierung ist der Prozess des Lesens einer Instanz eines XML-Dokuments und das Erstellen eines Objekts, das stark in das XML-Schema (XSD) des Dokuments eingegeben ist.
Vor der Deserialisierung muss ein XmlSerializer Objekt mithilfe des Typs deserialisiert werden.
Die XmlReader vom XML-Dokument angegebene Codierung wird automatisch erkannt und verwendet.
Note
Die XmlSerializer folgenden Arrays können nicht deserialisiert werden: Arrays von ArrayList und Arrays von List<T>.
Weitere Informationen
- XmlAttributes
- CanDeserialize(XmlReader)
- Serialize(TextWriter, Object)
- Einführung in die XML-Serialisierung
- Vorgehensweise: Angeben eines alternativen Elementnamens für einen XML-Stream
- Steuern der XML-Serialisierung mithilfe von Attributen
- Beispiele für die XML-Serialisierung
- XML Schema Definition-Tool (Xsd.exe)
Gilt für:
Deserialize(XmlReader, String)
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
Deserialisiert das XML-Dokument, das in der angegebenen XmlReader und Codierungsformatvorlage enthalten ist.
public:
System::Object ^ Deserialize(System::Xml::XmlReader ^ xmlReader, System::String ^ encodingStyle);
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("XML serializer relies on dynamic code generation which is not available with Ahead of Time compilation")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")]
public object? Deserialize(System.Xml.XmlReader xmlReader, string? encodingStyle);
public object? Deserialize(System.Xml.XmlReader xmlReader, string? encodingStyle);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")]
public object? Deserialize(System.Xml.XmlReader xmlReader, string? encodingStyle);
public object Deserialize(System.Xml.XmlReader xmlReader, string encodingStyle);
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("XML serializer relies on dynamic code generation which is not available with Ahead of Time compilation")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")>]
member this.Deserialize : System.Xml.XmlReader * string -> obj
member this.Deserialize : System.Xml.XmlReader * string -> obj
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")>]
member this.Deserialize : System.Xml.XmlReader * string -> obj
Public Function Deserialize (xmlReader As XmlReader, encodingStyle As String) As Object
Parameter
- encodingStyle
- String
The encoding style of the serialized XML.
Gibt zurück
Das deserialisierte Objekt.
- Attribute
Ausnahmen
Fehler bei der Deserialisierung. Die ursprüngliche Ausnahme ist mit der InnerException Eigenschaft verfügbar.
Hinweise
Die Deserialisierung ist der Prozess des Lesens einer Instanz eines XML-Dokuments und das Erstellen eines Objekts, das stark in das XML-Schema (XSD) des Dokuments eingegeben ist.
Vor der Deserialisierung muss ein XmlSerializer Objekt mithilfe des Typs deserialisiert werden.
Legen Sie den encodingStyle Parameter auf "http://schemas.xmlsoap.org/soap/encoding/" für soap Version 1.1-Codierung fest. Andernfalls legen Sie ihn für soap Version 1.2-Codierung auf "http://www.w3.org/2001/12/soap-encoding" fest.
Hinweis Die XmlSerializer folgenden Arrays können nicht deserialisiert werden: Arrays von ArrayList und Arrays von List<T>.
Weitere Informationen
- XmlAttributes
- CanDeserialize(XmlReader)
- Serialize(TextWriter, Object)
- Einführung in die XML-Serialisierung
- Vorgehensweise: Angeben eines alternativen Elementnamens für einen XML-Stream
- Steuern der XML-Serialisierung mithilfe von Attributen
- Beispiele für die XML-Serialisierung
- XML Schema Definition-Tool (Xsd.exe)
Gilt für:
Deserialize(XmlReader, XmlDeserializationEvents)
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
Deserialisiert ein XML-Dokument, das in dem angegebenen XmlReader Dokument enthalten ist, und ermöglicht die Außerkraftsetzung von Ereignissen, die während der Deserialisierung auftreten.
public:
System::Object ^ Deserialize(System::Xml::XmlReader ^ xmlReader, System::Xml::Serialization::XmlDeserializationEvents events);
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("XML serializer relies on dynamic code generation which is not available with Ahead of Time compilation")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")]
public object? Deserialize(System.Xml.XmlReader xmlReader, System.Xml.Serialization.XmlDeserializationEvents events);
public object? Deserialize(System.Xml.XmlReader xmlReader, System.Xml.Serialization.XmlDeserializationEvents events);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")]
public object? Deserialize(System.Xml.XmlReader xmlReader, System.Xml.Serialization.XmlDeserializationEvents events);
public object Deserialize(System.Xml.XmlReader xmlReader, System.Xml.Serialization.XmlDeserializationEvents events);
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("XML serializer relies on dynamic code generation which is not available with Ahead of Time compilation")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")>]
member this.Deserialize : System.Xml.XmlReader * System.Xml.Serialization.XmlDeserializationEvents -> obj
member this.Deserialize : System.Xml.XmlReader * System.Xml.Serialization.XmlDeserializationEvents -> obj
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")>]
member this.Deserialize : System.Xml.XmlReader * System.Xml.Serialization.XmlDeserializationEvents -> obj
Public Function Deserialize (xmlReader As XmlReader, events As XmlDeserializationEvents) As Object
Parameter
- events
- XmlDeserializationEvents
Eine Instanz der XmlDeserializationEvents-Klasse.
Gibt zurück
Die Object Deserialisierung.
- Attribute
Hinweise
Das Objekt, das deserialisiert wird.
Gilt für:
Deserialize(XmlReader, String, XmlDeserializationEvents)
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
- Quelle:
- XmlSerializer.cs
Deserialisiert das Objekt mithilfe der daten, die im angegebenen Objekt XmlReaderenthalten sind.
public:
System::Object ^ Deserialize(System::Xml::XmlReader ^ xmlReader, System::String ^ encodingStyle, System::Xml::Serialization::XmlDeserializationEvents events);
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("XML serializer relies on dynamic code generation which is not available with Ahead of Time compilation")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")]
public object? Deserialize(System.Xml.XmlReader xmlReader, string? encodingStyle, System.Xml.Serialization.XmlDeserializationEvents events);
public object? Deserialize(System.Xml.XmlReader xmlReader, string? encodingStyle, System.Xml.Serialization.XmlDeserializationEvents events);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")]
public object? Deserialize(System.Xml.XmlReader xmlReader, string? encodingStyle, System.Xml.Serialization.XmlDeserializationEvents events);
public object Deserialize(System.Xml.XmlReader xmlReader, string encodingStyle, System.Xml.Serialization.XmlDeserializationEvents events);
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("XML serializer relies on dynamic code generation which is not available with Ahead of Time compilation")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")>]
member this.Deserialize : System.Xml.XmlReader * string * System.Xml.Serialization.XmlDeserializationEvents -> obj
member this.Deserialize : System.Xml.XmlReader * string * System.Xml.Serialization.XmlDeserializationEvents -> obj
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from deserialized types may be trimmed if not referenced directly")>]
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
Parameter
- encodingStyle
- String
Die verwendete Codierung.
- events
- XmlDeserializationEvents
Eine Instanz der XmlDeserializationEvents-Klasse.
Gibt zurück
Das Objekt, das deserialisiert wird.
- Attribute
Hinweise
Diese Methode ist nur für die Deserialisierung unbekannter Header für Webdienstszenarien erforderlich. Mit dieser Methode können Sie die Ereignissynchronisierung in Webdienstmethoden vermeiden.