System.Runtime.Serialization Namespace

Der System.Runtime.Serialization-Namespace enthält Klassen, mit denen Objekte serialisiert und deserialisiert werden können. The System.Runtime.Serialization namespace contains classes that can be used for serializing and deserializing objects. Bei der Serialisierung handelt es sich um die Konvertierung eines Objekts oder eines Objektdiagramms in eine lineare Folge von Bytes, die entweder gespeichert oder an einen anderen Ort übertragen werden. Serialization is the process of converting an object or a graph of objects into a linear sequence of bytes for either storage or transmission to another location. Bei der Deserialisierung werden gespeicherte Informationen erfasst und erneut Objekte daraus erstellt. Deserialization is the process of taking in stored information and recreating objects from it.

Klassen

CollectionDataContractAttribute

Ermöglich bei Anwendung auf einen Auflistungstyp die benutzerdefinierte Angabe der Auflistungselemente.When applied to a collection type, enables custom specification of the collection item elements. Dieses Attribut kann nur auf Typen angewendet werden, die vom DataContractSerializer als gültige, serialisierbare Auflistungen erkannt werden.This attribute can be applied only to types that are recognized by the DataContractSerializer as valid, serializable collections.

ContractNamespaceAttribute

Gibt den CLR-Namespace und den XML-Namespace des Datenvertrags an.Specifies the CLR namespace and XML namespace of the data contract.

DataContractAttribute

Gibt an, dass der Typ einen Datenvertrag definiert oder implementiert und mit einem Serialisierer wie dem DataContractSerializer serialisierbar ist.Specifies that the type defines or implements a data contract and is serializable by a serializer, such as the DataContractSerializer. Um ihren Typ serialisierbar zu machen, müssen die Autoren hierfür einen Datenvertrag definieren.To make their type serializable, type authors must define a data contract for their type.

DataContractResolver

Stellt einen Mechanismus bereit, mit dem bei der Serialisierung und der Deserialisierung Typen xsi:type-Darstellungen zugeordnet werden können bzw. diese Zuordnung aufgehoben werden kann.Provides a mechanism for dynamically mapping types to and from xsi:type representations during serialization and deserialization.

DataContractSerializer

Serialisiert oder deserialisiert mithilfe eines bereitgestellten Datenvertrags eine Instanz eines Typs in einen XML-Stream oder in ein XML-Dokument.Serializes and deserializes an instance of a type into an XML stream or document using a supplied data contract. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

DataContractSerializerExtensions

Erweitert die DataContractSerializer-Klasse durch Methoden zum Festlegen und Abrufen einer ISerializationSurrogateProvider.Extends the DataContractSerializer class by providing methods for setting and getting an ISerializationSurrogateProvider.

DataContractSerializerSettings

Gibt Einstellungen für das Datenvertragsserialisierungsprogramm an.Specifies data contract serializer settings.

DataMemberAttribute

Gibt bei Anwendung auf den Member eines Typs an, dass der Member Teil eines Datenvertrags ist und über den DataContractSerializer serialisierbar ist.When applied to the member of a type, specifies that the member is part of a data contract and is serializable by the DataContractSerializer.

DateTimeFormat

Gibt Datum/Zeit-Formatoptionen an.Specifies date-time format options.

EnumMemberAttribute

Gibt an, dass das Feld ein Enumerationsmember ist und serialisiert werden sollte.Specifies that the field is an enumeration member and should be serialized.

ExportOptions

Stellt die Optionen dar, die für ein XsdDataContractExporter festgelegt werden können.Represents the options that can be set for an XsdDataContractExporter.

ExtensionDataObject

Speichert Daten eines Datenvertrags mit Versionsangabe, der durch das Hinzufügen neuer Member erweitert wurde.Stores data from a versioned data contract that has been extended by adding new members.

Formatter

Stellt die Basisfunktionen für die Formatierungsprogramme der Common Language Runtime zur Serialisierung bereit.Provides base functionality for the common language runtime serialization formatters.

FormatterConverter

Stellt eine Basisimplementierung der IFormatterConverter-Schnittstelle dar, die die Convert-Klasse und die IConvertible-Schnittstelle verwendet.Represents a base implementation of the IFormatterConverter interface that uses the Convert class and the IConvertible interface.

FormatterServices

Stellt statische Methoden bereit, die die Implementierung eines Formatter für die Serialisierung unterstützen.Provides static methods to aid with the implementation of a Formatter for serialization. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

IgnoreDataMemberAttribute

Gibt bei Anwendung auf den Member eines Typs an, dass der Member nicht Teil eines Datenvertrags und nicht serialisiert ist.When applied to the member of a type, specifies that the member is not part of a data contract and is not serialized.

ImportOptions

Stellt die Optionen dar, die auf einen XsdDataContractImporter festgelegt werden können.Represents the options that can be set on an XsdDataContractImporter.

InvalidDataContractException

Die Ausnahme, die ausgelöst wird, wenn der DataContractSerializer oder der NetDataContractSerializer bei der Serialisierung oder Deserialisierung auf einen ungültigen Datenvertrag trifft.The exception that is thrown when the DataContractSerializer or NetDataContractSerializer encounters an invalid data contract during serialization and deserialization.

KnownTypeAttribute

Gibt Typen an, die vom DataContractSerializer beim Serialisieren oder Deserialisieren eines bestimmten Typs erkannt werden sollen.Specifies types that should be recognized by the DataContractSerializer when serializing or deserializing a given type.

NetDataContractSerializer

Serialisiert oder deserialisiert mithilfe der bereitgestellten .NET Framework-Typen eine Instanz eines Typs in einen XML-Stream oder ein XML-Dokument.Serializes and deserializes an instance of a type into XML stream or document using the supplied .NET Framework types. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

ObjectIDGenerator

Generiert IDs für Objekte.Generates IDs for objects.

ObjectManager

Verfolgt Objekte während der Deserialisierung.Keeps track of objects as they are deserialized.

OnDeserializedAttribute

Gibt bei Anwendung auf eine Methode an, dass die Methode sofort nach der Serialisierung eines Objektgraphs in ein Objektdiagramm aufgerufen wird.When applied to a method, specifies that the method is called immediately after deserialization of an object in an object graph. Die Deserialisierungsreihenfolge relativ zu anderen Objekten im Diagramm ist nicht deterministisch.The order of deserialization relative to other objects in the graph is non-deterministic.

OnDeserializingAttribute

Gibt bei Anwendung auf eine Methode an, dass die Methode während der Deserialisierung eines Objekts in einem Objektdiagramm aufgerufen wird.When applied to a method, specifies that the method is called during deserialization of an object in an object graph. Die Deserialisierungsreihenfolge relativ zu anderen Objekten im Diagramm ist nicht deterministisch.The order of deserialization relative to other objects in the graph is non-deterministic.

OnSerializedAttribute

Gibt bei Anwendung auf eine Methode an, dass die Methode nach der Serialisierung eines Objekts in einem Objektdiagramm aufgerufen wird.When applied to a method, specifies that the method is called after serialization of an object in an object graph. Die Serialisierungsreihenfolge relativ zu anderen Objekten im Diagramm ist nicht deterministisch.The order of serialization relative to other objects in the graph is non-deterministic.

OnSerializingAttribute

Gibt bei Anwendung auf eine Methode an, dass die Methode während der Serialisierung eines Objekts in einem Objektdiagramm aufgerufen wird.When applied to a method, specifies that the method is during serialization of an object in an object graph. Die Serialisierungsreihenfolge relativ zu anderen Objekten im Diagramm ist nicht deterministisch.The order of serialization relative to other objects in the graph is non-deterministic.

OptionalFieldAttribute

Gibt an, dass ein Feld in einem Serialisierungsstream fehlen kann, sodass die BinaryFormatter-Klasse und die SoapFormatter-Klasse keine Ausnahme auslösen.Specifies that a field can be missing from a serialization stream so that the BinaryFormatter and the SoapFormatter does not throw an exception.

SafeSerializationEventArgs

Stellt Daten für das SerializeObjectState-Ereignis bereit.Provides data for the SerializeObjectState event.

SerializationBinder

Ermöglicht es Benutzern, das Laden von Klassen zu überwachen und zu bestimmen, welche Klasse geladen werden soll.Allows users to control class loading and mandate what class to load.

SerializationException

Die Ausnahme, die ausgelöst wird, wenn während der Serialisierung oder Deserialisierung ein Fehler auftritt.The exception thrown when an error occurs during serialization or deserialization.

SerializationInfo

Enthält sämtliche zum Serialisieren bzw. Deserialisieren eines Objekts benötigten Daten.Stores all the data needed to serialize or deserialize an object. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

SerializationInfoEnumerator

Stellt ein von Formatierungsprogrammen einfach zu verwendendes Verfahren für die Analyse der Daten in der SerializationInfo bereit.Provides a formatter-friendly mechanism for parsing the data in SerializationInfo. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

SerializationObjectManager

Verwaltet Serialisierungsprozesse zur Laufzeit.Manages serialization processes at run time. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

SurrogateSelector

Unterstützt Formatierungsprogrammen bei der Auswahl eines Serialisierungsersatzes, an den der Serialisierungs- oder Deserialisierungsvorgang delegiert werden soll.Assists formatters in selection of the serialization surrogate to delegate the serialization or deserialization process to.

XmlObjectSerializer

Stellt die Basisklasse bereit, die verwendet wird, um Objekte als XML-Streams oder XML-Dokumente zu serialisieren.Provides the base class used to serialize objects as XML streams or documents. Diese Klasse ist abstrakt.This class is abstract.

XmlSerializableServices

Enthält Methoden zum Lesen und Schreiben von XML.Contains methods for reading and writing XML.

XPathQueryGenerator

Generiert – wenn eine einen Datenvertrag darstellende Klasse und ein Vertragsmember darstellende Metadaten gegeben sind – eine XPath-Abfrage für den Member.When given a class representing a data contract, and metadata representing a member of the contract, produces an XPath query for the member.

XsdDataContractExporter

Ermöglicht die Transformation einer in Datenverträgen verwendeten Gruppe von .NET Framework-Typen in eine XML-Schemadatei (XSD).Allows the transformation of a set of .NET Framework types that are used in data contracts into an XML schema file (.xsd).

XsdDataContractImporter

Ermöglicht die Transformation einer Reihe von XML-Schemadateien (.xsd) in Common Language Runtime (CLR)-Typen.Allows the transformation of a set of XML schema files (.xsd) into common language runtime (CLR) types.

Strukturen

SerializationEntry

Enthält den Wert, den Type und den Namen eines serialisierten Objekts.Holds the value, Type, and name of a serialized object.

StreamingContext

Beschreibt die Quelle und das Ziel eines angegebenen serialisierten Streams und stellt einen zusätzlichen aufruferdefinierten Kontext bereit.Describes the source and destination of a given serialized stream, and provides an additional caller-defined context.

Schnittstellen

IDataContractSurrogate

Stellt die erforderlichen Methoden bereit, um mithilfe des DataContractSerializer bei der Serialisierung, der Deserialisierung und beim Export und Import von XSD (XML Schema Documents) einen Typen durch einen anderen zu ersetzen.Provides the methods needed to substitute one type for another by the DataContractSerializer during serialization, deserialization, and export and import of XML schema documents (XSD).

IDeserializationCallback

Gibt an, dass eine Klasse bei Abschluss der Deserialisierung des vollständigen Objektdiagramms benachrichtigt werden soll.Indicates that a class is to be notified when deserialization of the entire object graph has been completed. Beachten Sie, dass diese Schnittstelle bei der Deserialisierung nicht mit dem XmlSerializer (System.Xml.Serialization.XmlSerializer) aufgerufen wird.Note that this interface is not called when deserializing with the XmlSerializer (System.Xml.Serialization.XmlSerializer).

IExtensibleDataObject

Stellt eine Datenstruktur zur Speicherung zusätzlicher Daten zur Verfügung, die vom XmlObjectSerializer bei der Deserialisierung eines Typs angetroffen wurden, der mit dem DataContractAttribute-Attribut gekennzeichnet ist.Provides a data structure to store extra data encountered by the XmlObjectSerializer during deserialization of a type marked with the DataContractAttribute attribute.

IFormatter

Stellt Funktionen für das Formatieren serialisierter Objekte bereit.Provides functionality for formatting serialized objects.

IFormatterConverter

Liefert die Verbindung zwischen einer Instanz von SerializationInfo und der vom Formatierungsprogramm bereitgestellten Klasse, die sich am besten zum Analysieren der Daten in der SerializationInfo eignet.Provides the connection between an instance of SerializationInfo and the formatter-provided class best suited to parse the data inside the SerializationInfo.

IObjectReference

Gibt an, dass die aktuelle Schnittstellenimplementierung ein Verweis auf ein anderes Objekt ist.Indicates that the current interface implementer is a reference to another object.

ISafeSerializationData

Aktiviert die Serialisierung von benutzerdefinierten Ausnahmedaten in sicherheitstransparentem Code.Enables serialization of custom exception data in security-transparent code.

ISerializable

Ermöglicht einem Objekt, die eigene Serialisierung und Deserialisierung zu überwachen.Allows an object to control its own serialization and deserialization.

ISerializationSurrogate

Implementiert einen Selektor für einen Serialisierungsersatz, mit dem ein Objekt ein anderes Objekt serialisieren und deserialisieren kann.Implements a serialization surrogate selector that allows one object to perform serialization and deserialization of another.

ISerializationSurrogateProvider

Stellt die Methoden bereit, die für die Konstruktion eines Serialisierungsersatzes erforderlich sind, der das DataContractSerializer-Objekt erweitert.Provides the methods needed to construct a serialization surrogate that extends the DataContractSerializer. Ein Serialisierungsersatz wird während der Serialisierung und Deserialisierung verwendet, um einen Typ durch einen anderen zu ersetzen.A serialization surrogate is used during serialization and deserialization to substitute one type for another.

ISurrogateSelector

Gibt eine Ersatzselektorklasse für die Serialisierung an.Indicates a serialization surrogate selector class.

Enumerationen

EmitTypeInformation

Gibt an, wie oft Typinformationen ausgegeben werden.Specifies how often to emit type information.

StreamingContextStates

Definiert einen Satz von Flags, der den Quell- oder Zielkontext für den Datenstrom während der Serialisierung angibt.Defines a set of flags that specifies the source or destination context for the stream during serialization.

Hinweise

Die ISerializable-Schnittstelle ermöglicht Klassen das Steuern des eigenen Serialisierungsverhaltens.The ISerializable interface provides a way for classes to control their own serialization behavior. Klassen in der System.Runtime.Serialization.Formatters Namespace steuern die tatsächliche Formatierung der verschiedenen Datentypen in den serialisierten Objekten gekapselt.Classes in the System.Runtime.Serialization.Formatters namespace control the actual formatting of various data types encapsulated in the serialized objects.

Formatierer, die zum Serialisieren und Deserialisieren von Objekten, die in und aus einem bestimmten Format finden Sie in der System.Runtime.Serialization.Formatters Namespace.Formatters that serialize and deserialize objects to and from a particular format can be found in the System.Runtime.Serialization.Formatters namespace.