DataContractSerializer Klasse
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.
Serialisiert und deserialisiert eine Instanz eines Typs in einen XML-Datenstrom oder -dokument mithilfe eines bereitgestellten Datenvertrags. Diese Klasse kann nicht vererbt werden.
public ref class DataContractSerializer sealed : System::Runtime::Serialization::XmlObjectSerializerpublic sealed class DataContractSerializer : System.Runtime.Serialization.XmlObjectSerializertype DataContractSerializer = class
inherit XmlObjectSerializerPublic NotInheritable Class DataContractSerializer
Inherits XmlObjectSerializer- Vererbung
Hinweise
Weitere Informationen zu dieser API finden Sie in den ergänzenden API-Hinweisen für DataContractSerializer.
Konstruktoren
| Name | Beschreibung |
|---|---|
| DataContractSerializer(Type, DataContractSerializerSettings) |
Initialisiert eine neue Instanz der DataContractSerializer Klasse, um ein Objekt des angegebenen Typs und der angegebenen Einstellungen zu serialisieren oder deserialisieren. |
| DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Initialisiert eine neue Instanz der DataContractSerializer Klasse, um ein Objekt des angegebenen Typs zu serialisieren oder deserialisieren. Diese Methode gibt auch eine Liste bekannter Typen an, die im Objektdiagramm vorhanden sein können, die maximale Anzahl von Diagrammelementen, die serialisiert werden sollen, Parameter, um unerwartete Daten zu ignorieren, ob nicht standardmäßige XML-Konstrukte zum Beibehalten von Objektverweisdaten im Diagramm, eine Ersatz für die benutzerdefinierte Serialisierung und eine Alternative für Zuordnungsdeklarationen |
| DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Initialisiert eine neue Instanz der DataContractSerializer Klasse, um ein Objekt des angegebenen Typs zu serialisieren oder deserialisieren. Diese Methode gibt auch eine Liste bekannter Typen an, die im Objektdiagramm vorhanden sein können, die maximale Anzahl von Diagrammelementen, die serialisiert werden sollen, Parameter, um unerwartete Daten zu ignorieren, ob nicht standardmäßige XML-Konstrukte zum Beibehalten von Objektverweisdaten im Diagramm und ein Ersatz für die benutzerdefinierte Serialisierung verwendet werden sollen. |
| DataContractSerializer(Type, IEnumerable<Type>) |
Initialisiert eine neue Instanz der DataContractSerializer Klasse, um ein Objekt des angegebenen Typs zu serialisieren oder deserialisieren, und eine Auflistung bekannter Typen, die im Objektdiagramm vorhanden sein können. |
| DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Initialisiert eine neue Instanz der DataContractSerializer Klasse, um ein Objekt des angegebenen Typs zu serialisieren oder deserialisieren. Diese Methode gibt auch eine Liste bekannter Typen an, die im Objektdiagramm vorhanden sein können, die maximale Anzahl von Diagrammelementen, die serialisiert werden sollen, Parameter, um unerwartete Daten zu ignorieren, ob nicht standardmäßige XML-Konstrukte verwendet werden, um Objektverweisdaten im Diagramm beizubehalten, eine Ersatz für die benutzerdefinierte Serialisierung, das XML-Element und den Namespace, das den Inhalt enthält, und eine Alternative zum Zuordnen |
| DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Initialisiert eine neue Instanz der DataContractSerializer Klasse, um ein Objekt des angegebenen Typs zu serialisieren oder deserialisieren. Diese Methode gibt auch eine Liste bekannter Typen an, die im Objektdiagramm vorhanden sein können, die maximale Anzahl von Diagrammelementen, die serialisiert werden sollen, Parameter, um unerwartete Daten zu ignorieren, ob nicht standardmäßige XML-Konstrukte zum Beibehalten von Objektverweisdaten im Diagramm, ein Ersatz für die benutzerdefinierte Serialisierung und das XML-Element und den Namespace verwendet werden sollen, die den Inhalt enthalten. |
| DataContractSerializer(Type, String, String, IEnumerable<Type>) |
Initialisiert eine neue Instanz der DataContractSerializer Klasse, um ein Objekt des angegebenen Typs zu serialisieren oder deserialisieren. Diese Methode gibt auch das XML-Stammelement und den Namespace in zwei Zeichenfolgenparametern sowie eine Liste bekannter Typen an, die im Objektdiagramm vorhanden sein können. |
| DataContractSerializer(Type, String, String) |
Initialisiert eine neue Instanz der DataContractSerializer Klasse zum Serialisieren oder Deserialisieren eines Objekts des angegebenen Typs mithilfe des bereitgestellten XML-Stammelements und Namespaces. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Initialisiert eine neue Instanz der DataContractSerializer Klasse, um ein Objekt des angegebenen Typs zu serialisieren oder deserialisieren. Diese Methode gibt auch eine Liste bekannter Typen an, die im Objektdiagramm vorhanden sein können, die maximale Anzahl von Diagrammelementen, die serialisiert werden sollen, Parameter, um unerwartete Daten zu ignorieren, ob nicht standardmäßige XML-Konstrukte zum Beibehalten von Objektverweisdaten im Diagramm verwendet werden, eine Ersatz für die benutzerdefinierte Serialisierung, Parameter, die XmlDictionaryString das XML-Element und den Namespace angeben, die den Inhalt enthalten, und eine Alternative zum Zuordnen |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Initialisiert eine neue Instanz der DataContractSerializer Klasse, um ein Objekt des angegebenen Typs zu serialisieren oder deserialisieren. Diese Methode gibt auch eine Liste bekannter Typen an, die im Objektdiagramm vorhanden sein können, die maximale Anzahl von Diagrammelementen, die serialisiert werden sollen, Parameter, um unerwartete Daten zu ignorieren, ob nicht standardmäßige XML-Konstrukte zum Beibehalten von Objektverweisdaten im Diagramm, eine Ersatz für die benutzerdefinierte Serialisierung und Parameter verwendet werden, die XmlDictionaryString das XML-Element und den Namespace angeben, die den Inhalt enthalten. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>) |
Initialisiert eine neue Instanz der DataContractSerializer Klasse, um ein Objekt des angegebenen Typs zu serialisieren oder deserialisieren. Diese Methode gibt auch das XML-Stammelement und den Namespace in zwei XmlDictionaryString Parametern sowie eine Liste bekannter Typen an, die im Objektdiagramm vorhanden sein können. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString) |
Initialisiert eine neue Instanz der DataContractSerializer Klasse zum Serialisieren oder Deserialisieren eines Objekts des angegebenen Typs mithilfe des XML-Stammelements und namespaces, das über die Parameter des Typs XmlDictionaryStringangegeben wird. |
| DataContractSerializer(Type) |
Initialisiert eine neue Instanz der DataContractSerializer Klasse, um ein Objekt des angegebenen Typs zu serialisieren oder deserialisieren. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| DataContractResolver |
Ruft die Komponente ab, die zum dynamischen Zuordnen |
| DataContractSurrogate |
Ruft einen Ersatztyp ab, der den Serialisierungs- oder Deserialisierungsprozess erweitern kann. |
| IgnoreExtensionDataObject |
Ruft einen Wert ab, der angibt, ob Daten, die von einer Erweiterung der Klasse bereitgestellt werden, ignoriert werden sollen, wenn die Klasse serialisiert oder deserialisiert wird. |
| KnownTypes |
Ruft eine Auflistung von Typen ab, die mithilfe dieser Instanz des DataContractSerializerObjekts diagramms serialisiert werden können. |
| MaxItemsInObjectGraph |
Ruft die maximale Anzahl von Elementen in einem Objektdiagramm ab, um sie zu serialisieren oder deserialisieren. |
| PreserveObjectReferences |
Ruft einen Wert ab, der angibt, ob nicht standardmäßige XML-Konstrukte zum Beibehalten von Objektverweisdaten verwendet werden sollen. |
| SerializeReadOnlyTypes |
Ruft einen Wert ab, der angibt, ob schreibgeschützte Typen serialisiert werden. |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| IsStartObject(XmlDictionaryReader) |
Bestimmt, ob das XmlDictionaryReader Objekt in einem Objekt positioniert wird, das deserialisiert werden kann. |
| IsStartObject(XmlReader) |
Bestimmt, ob das XmlReader Objekt in einem Objekt positioniert wird, das deserialisiert werden kann. |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ReadObject(Stream) |
Liest den XML-Datenstrom oder das Dokument mit einem Stream und gibt das deserialisierte Objekt zurück. (Geerbt von XmlObjectSerializer) |
| ReadObject(XmlDictionaryReader, Boolean, DataContractResolver) |
Liest ein XML-Dokument oder einen Dokumentdatenstrom und gibt das deserialisierte Objekt zurück. Die Methode enthält einen Parameter, um anzugeben, ob der Objektname überprüft wird, und ein Resolver für die Zuordnung |
| ReadObject(XmlDictionaryReader, Boolean) |
Liest den XML-Datenstrom mit einem XmlDictionaryReader und gibt das deserialisierte Objekt zurück und gibt außerdem an, ob eine Überprüfung vorgenommen wird, um den Objektnamen vor dem Lesen des Werts zu überprüfen. |
| ReadObject(XmlDictionaryReader) |
Liest das XML-Dokument oder den Datenstrom mit einem XmlDictionaryReader und gibt das deserialisierte Objekt zurück. (Geerbt von XmlObjectSerializer) |
| ReadObject(XmlReader, Boolean) |
Liest den XML-Datenstrom mit einem XmlReader und gibt das deserialisierte Objekt zurück und gibt außerdem an, ob eine Überprüfung vorgenommen wird, um den Objektnamen vor dem Lesen des Werts zu überprüfen. |
| ReadObject(XmlReader) |
Liest den XML-Datenstrom mit einem XmlReader und gibt das deserialisierte Objekt zurück. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| WriteEndObject(XmlDictionaryWriter) |
Schreibt das schließende XML-Element mithilfe eines XmlDictionaryWriter. |
| WriteEndObject(XmlWriter) |
Schreibt das schließende XML-Element mithilfe eines XmlWriter. |
| WriteObject(Stream, Object) |
Schreibt den vollständigen Inhalt (Start, Inhalt und Ende) des Objekts in das XML-Dokument oder den Datenstrom mit dem angegebenen Stream. (Geerbt von XmlObjectSerializer) |
| WriteObject(XmlDictionaryWriter, Object, DataContractResolver) |
Schreibt alle Objektdaten (Start-XML-Element, Inhalt und eingeschlossenes Element) in ein XML-Dokument oder -Stream mit dem angegebenen XmlDictionaryWriter. Die Methode enthält einen Resolver für die Zuordnung |
| WriteObject(XmlDictionaryWriter, Object) |
Schreibt den vollständigen Inhalt (Start, Inhalt und Ende) des Objekts in das XML-Dokument oder den Datenstrom mit dem angegebenen XmlDictionaryWriter. (Geerbt von XmlObjectSerializer) |
| WriteObject(XmlWriter, Object) |
Schreibt alle Objektdaten (Start-XML-Element, Inhalt und schließende Element) in ein XML-Dokument oder -Datenstrom mit einem XmlWriter. |
| WriteObjectContent(XmlDictionaryWriter, Object) |
Schreibt den XML-Inhalt mithilfe eines XmlDictionaryWriter. |
| WriteObjectContent(XmlWriter, Object) |
Schreibt den XML-Inhalt mithilfe eines XmlWriter. |
| WriteStartObject(XmlDictionaryWriter, Object) |
Schreibt das öffnende XML-Element mithilfe eines XmlDictionaryWriter. |
| WriteStartObject(XmlWriter, Object) |
Schreibt das öffnende XML-Element mithilfe eines XmlWriter. |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| GetSerializationSurrogateProvider(DataContractSerializer) |
Gibt den Ersatz serialisierungsanbieter für diesen Serialisierer zurück. |
| SetSerializationSurrogateProvider(DataContractSerializer, ISerializationSurrogateProvider) |
Gibt einen Ersatz serialisierungsanbieter für diese DataContractSerializeran. |
Gilt für:
Threadsicherheit
Instanzen dieser Klasse sind threadsicher, es sei denn, die Instanz wird mit einer Implementierung der IDataContractSurrogate Oder verwendet DataContractResolver.