DataContractSerializer Klasse

Definition

Serialisiert oder deserialisiert mithilfe eines bereitgestellten Datenvertrags eine Instanz eines Typs in einen XML-Stream oder in ein XML-Dokument. Diese Klasse kann nicht vererbt werden.

public ref class DataContractSerializer sealed : System::Runtime::Serialization::XmlObjectSerializer
public sealed class DataContractSerializer : System.Runtime.Serialization.XmlObjectSerializer
type DataContractSerializer = class
    inherit XmlObjectSerializer
Public NotInheritable Class DataContractSerializer
Inherits XmlObjectSerializer
Vererbung
DataContractSerializer

Hinweise

Weitere Informationen zu dieser API finden Sie unter Ergänzende API-Hinweise für DataContractSerializer.

Konstruktoren

DataContractSerializer(Type)

Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs zu serialisieren bzw. zu deserialisieren.

DataContractSerializer(Type, DataContractSerializerSettings)

Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs und Einstellungen zu serialisieren bzw. zu deserialisieren.

DataContractSerializer(Type, IEnumerable<Type>)

Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs sowie eine Auflistung bekannter Typen, die im Objektdiagramm vorhanden sind, zu serialisieren bzw. zu deserialisieren.

DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs zu serialisieren bzw. zu deserialisieren. Diese Methode nennt zudem eine Liste bekannter Typen, die ggf. im Objektdiagramm enthalten sind, sowie die maximale Anzahl von zu serialisierenden Diagrammelementen und Parameter zum Ignorieren nicht erwarteter Daten. Weiterhin kennzeichnet sie, ob nicht standardmäßige XML-Konstrukte verwendet werden, um Objektverweisdaten im Diagramm beizubehalten, und ob ein Ersatzzeichen für eine benutzerdefinierte Serialisierung verwendet wird.

DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)

Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs zu serialisieren bzw. zu deserialisieren. Diese Methode nennt zudem eine Liste bekannter Typen, die ggf. im Objektdiagramm enthalten sind, sowie die maximale Anzahl von zu serialisierenden Diagrammelementen und Parameter zum Ignorieren nicht erwarteter Daten. Weiterhin kennzeichnet sie, ob nicht standardmäßige XML-Konstrukte verwendet werden, um Objektverweisdaten im Diagramm beizubehalten, und ob ein Ersatzzeichen für eine benutzerdefinierte Serialisierung verwendet wird. Sie enthält außerdem eine Alternative zur Zuordnung von xsi:type-Deklarationen zur Laufzeit.

DataContractSerializer(Type, String, String)

Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs mithilfe des bereitgestellten XML-Stammelements und -Namespace zu serialisieren bzw. zu deserialisieren.

DataContractSerializer(Type, String, String, IEnumerable<Type>)

Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs zu serialisieren bzw. zu deserialisieren. Darüber hinaus gibt diese Methode das XML-Stammelement und den Namespace in zwei Zeichenfolgenparametern sowie eine Liste bekannter Typen, die in dem Objektdiagramm ggf. enthalten sind, an.

DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs zu serialisieren bzw. zu deserialisieren. Diese Methode nennt zudem eine Liste bekannter Typen, die ggf. im Objektdiagramm enthalten sind, sowie die maximale Anzahl von zu serialisierenden Diagrammelementen und Parameter zum Ignorieren nicht erwarteter Daten. Weiterhin kennzeichnet sie, ob nicht standardmäßige XML-Konstrukte verwendet werden, um Objektverweisdaten im Diagramm beizubehalten, und ob ein Ersatzzeichen für eine benutzerdefinierte Serialisierung verwendet wird. Sie enthält außerdem das XML-Element und den Namespace, die den Inhalt enthalten.

DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)

Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs zu serialisieren bzw. zu deserialisieren. Diese Methode nennt zudem eine Liste bekannter Typen, die ggf. im Objektdiagramm enthalten sind, sowie die maximale Anzahl von zu serialisierenden Diagrammelementen und Parameter zum Ignorieren nicht erwarteter Daten. Weiterhin kennzeichnet sie, ob nicht standardmäßige XML-Konstrukte verwendet werden, um Objektverweisdaten im Diagramm beizubehalten, und ob ein Ersatzzeichen für eine benutzerdefinierte Serialisierung verwendet wird. Das XML-Element und der XML-Namespace mit dem Inhalt sind ebenfalls angegeben. Die Methode enthält außerdem eine Alternative zur Zuordnung von xsi:type-Deklarationen zur Laufzeit.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString)

Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs mithilfe des XML-Stammelements und -Namespaces zu serialisieren bzw. zu deserialisieren, das/der durch die Parameter des Typs XmlDictionaryString angegeben wird.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>)

Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs zu serialisieren bzw. zu deserialisieren. Darüber hinaus gibt diese Methode das XML-Stammelement und den Namespace in zwei XmlDictionaryString-Parametern sowie eine Liste bekannter Typen, die in dem Objektdiagramm ggf. enthalten sind, an.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs zu serialisieren bzw. zu deserialisieren. Diese Methode nennt zudem eine Liste bekannter Typen, die ggf. im Objektdiagramm enthalten sind, sowie die maximale Anzahl von zu serialisierenden Diagrammelementen und Parameter zum Ignorieren nicht erwarteter Daten. Weiterhin kennzeichnet sie, ob nicht standardmäßige XML-Konstrukte verwendet werden, um Objektverweisdaten im Diagramm beizubehalten, und ob ein Ersatzzeichen für eine benutzerdefinierte Serialisierung verwendet wird. Sie enthält außerdem Parameter des Typs XmlDictionaryString, die das XML-Element und den Namespace angeben, die den Inhalt enthalten.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)

Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs zu serialisieren bzw. zu deserialisieren. Diese Methode nennt zudem eine Liste bekannter Typen, die ggf. im Objektdiagramm enthalten sind, sowie die maximale Anzahl von zu serialisierenden Diagrammelementen und Parameter zum Ignorieren nicht erwarteter Daten. Weiterhin kennzeichnet sie, ob nicht standardmäßige XML-Konstrukte verwendet werden, um Objektverweisdaten im Diagramm beizubehalten, und ob ein Ersatzzeichen für eine benutzerdefinierte Serialisierung verwendet wird. Parameter von XmlDictionaryString, die das XML-Element und den XML-Namespace mit dem Inhalt angeben, sind ebenfalls angegeben. Die Methode enthält außerdem eine Alternative zur Zuordnung von xsi:type-Deklarationen zur Laufzeit.

Eigenschaften

DataContractResolver

Ruft die Komponente für die dynamische Zuordnung von xsi:type-Deklarationen zu bekannten Vertragstypen ab.

DataContractSurrogate

Ruft einen Ersatzzeichentyp ab, der den Serialisierungs- oder Deserialisierungsprozess erweitern kann.

IgnoreExtensionDataObject

Ruft einen Wert ab, der angibt, ob die von einer Erweiterung der Klasse bereitgestellten Daten ignoriert werden sollen, wenn die Klasse serialisiert oder deserialisiert wird.

KnownTypes

Ruft eine Auflistung der Typen in einem Objektdiagramm ab, die mithilfe einer Instanz des DataContractSerializer-Objekts serialisiert werden.

MaxItemsInObjectGraph

Ruft die maximale Anzahl von Elementen in einem Objektdiagramm ab, die serialisiert oder deserialisiert werden.

PreserveObjectReferences

Ruft einen Wert ab, der angibt, ob zum Beibehalten von Objektverweisdaten nicht standardmäßige XML-Konstrukte verwendet werden sollen.

SerializeReadOnlyTypes

Ruft einen Wert ab, der angibt, ob schreibgeschützte Typen serialisiert werden.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
IsStartObject(XmlDictionaryReader)

Bestimmt, ob der XmlDictionaryReader auf einem Objekt positioniert ist, das deserialisiert werden kann.

IsStartObject(XmlReader)

Bestimmt, ob der XmlReader auf einem Objekt positioniert ist, das deserialisiert werden kann.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ReadObject(Stream)

Liest den XML-Stream oder das XML-Dokument mit einem Stream und gibt das deserialisierte Objekt zurück.

(Geerbt von XmlObjectSerializer)
ReadObject(XmlDictionaryReader)

Liest das XML-Dokument oder den XML-Stream mit einem XmlDictionaryReader und gibt das deserialisierte Objekt zurück.

(Geerbt von XmlObjectSerializer)
ReadObject(XmlDictionaryReader, Boolean)

Liest den XML-Stream mit einem XmlDictionaryReader und gibt das deserialisierte Objekt zurück. Zudem wird angegeben, ob vor dem Lesen des Objektwerts der Objektname überprüft wird.

ReadObject(XmlDictionaryReader, Boolean, DataContractResolver)

Liest ein XML-Dokument oder einen XML-Dokumentstream und gibt das deserialisierte Objekt zurück. Die Methode enthält einen Parameter, der angibt, ob der Objektname überprüft/validiert wird, sowie einen Resolver zum Zuordnen von xsi:type-Deklarationen zur Laufzeit.

ReadObject(XmlReader)

Liest den XML-Stream mit einem XmlReader und gibt das deserialisierte Objekt zurück.

ReadObject(XmlReader, Boolean)

Liest den XML-Stream mit einem XmlReader und gibt das deserialisierte Objekt zurück. Zudem wird angegeben, ob vor dem Lesen des Objektwerts der Objektname überprüft wird.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
WriteEndObject(XmlDictionaryWriter)

Schreibt das abschließende XML-Element mit einem XmlDictionaryWriter.

WriteEndObject(XmlWriter)

Schreibt das abschließende XML-Element mit einem XmlWriter.

WriteObject(Stream, Object)

Schreibt den vollständigen Inhalt (Anfang, Inhalt und Ende) des Objekts in das XML-Dokument oder den XML-Stream mit dem angegebenen Stream.

(Geerbt von XmlObjectSerializer)
WriteObject(XmlDictionaryWriter, Object)

Schreibt den vollständigen Inhalt (Anfang, Inhalt und Ende) des Objekts in das XML-Dokument oder den XML-Stream mit dem angegebenen XmlDictionaryWriter.

(Geerbt von XmlObjectSerializer)
WriteObject(XmlDictionaryWriter, Object, DataContractResolver)

Schreibt alle Objektdaten (XML-Startelement, Inhalt und einschließendes Element) mit dem angegebenen XmlDictionaryWriter in ein XML-Dokument oder einen XML-Stream. Die Methode umfasst einen Resolver zum Zuordnen von xsi:type-Deklarationen zur Laufzeit.

WriteObject(XmlWriter, Object)

Schreibt alle Objektdaten (XML-Startelement, Inhalt und abschließendes Element) mit einem XmlWriter in ein XML-Dokument oder einen XML-Stream.

WriteObjectContent(XmlDictionaryWriter, Object)

Schreibt den XML-Inhalt mit einem XmlDictionaryWriter.

WriteObjectContent(XmlWriter, Object)

Schreibt den XML-Inhalt mit einem XmlWriter.

WriteStartObject(XmlDictionaryWriter, Object)

Schreibt das öffnende XML-Element mit einem XmlDictionaryWriter.

WriteStartObject(XmlWriter, Object)

Schreibt das öffnende XML-Element mit einem XmlWriter.

Erweiterungsmethoden

GetSerializationSurrogateProvider(DataContractSerializer)

Gibt den niedrigen Serialisierungsanbieter für dieses Serialisierungsmodul zurück.

SetSerializationSurrogateProvider(DataContractSerializer, ISerializationSurrogateProvider)

Gibt den Ersatzserialisierungsanbieter für dieses DataContractSerializer an.

Gilt für:

Threadsicherheit

Instanzen dieser Klasse sind threadsicher, außer wenn die instance mit einer Implementierung von IDataContractSurrogate oder DataContractResolververwendet wird.

Weitere Informationen