DataContractJsonSerializer Klasse

Definition

Namespace:
System.Runtime.Serialization.Json
Assemblys:
System.Runtime.Serialization.dll, System.Runtime.Serialization.Json.dll
Assembly:
System.ServiceModel.Web.dll
Assembly:
System.Runtime.Serialization.dll
Assembly:
netstandard.dll

Serialisiert Objekte in die JavaScript Object Notation (JSON) und deserialisiert JSON-Daten in Objekten. Diese Klasse kann nicht vererbt werden.

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

Hinweise

Für die meisten Szenarien, die die Serialisierung in JSON und deserialisieren von JSON erfordern, empfehlen wir die APIs im System.Text.Json-Namespace.

Wenn Für Ihr Szenario die DataContractJsonSerializer Klasse erforderlich ist, können Sie sie verwenden, um Instanzen eines Typs in ein JSON-Dokument zu serialisieren und ein JSON-Dokument in eine Instanz eines Typs deserialisieren. Sie können z. B. einen Typ Person mit Eigenschaften erstellen, die wesentliche Daten enthalten, z. B. einen Namen und eine Adresse. Anschließend können Sie eine Instanz der Person Klasse erstellen und bearbeiten und alle zugehörigen Eigenschaftswerte in einem JSON-Dokument zum späteren Abruf schreiben. Dieses JSON-Dokument kann später in die Person Klasse oder eine andere Klasse mit einem entsprechenden Datenvertrag deserialisiert werden.

Wenn während der Serialisierung einer ausgehenden Antwort auf dem Server ein Fehler auftritt oder der Antwortvorgang eine Ausnahme aus irgendeinem anderen Grund auslöst, wird sie möglicherweise nicht als Fehler an den Client zurückgegeben.

Konstruktoren

Name Beschreibung
DataContractJsonSerializer(Type, DataContractJsonSerializerSettings)

Initialisiert eine neue Instanz der DataContractJsonSerializer Klasse, um ein Objekt des angegebenen Typs und der Serialisierungseinstellungen zu serialisieren oder deserialisieren.
DataContractJsonSerializer(Type, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)

Initialisiert eine neue Instanz der DataContractJsonSerializer 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 oder deserialisiert werden sollen, ob unerwartete Daten ignoriert oder Typinformationen ausgegeben werden sollen, und ein Ersatz für die benutzerdefinierte Serialisierung.
DataContractJsonSerializer(Type, IEnumerable<Type>)

Initialisiert eine neue Instanz der DataContractJsonSerializer Klasse zum Serialisieren oder Deserialisieren eines Objekts des angegebenen Typs mit einer Auflistung bekannter Typen, die im Objektdiagramm vorhanden sein können.
DataContractJsonSerializer(Type, String, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)

Initialisiert eine neue Instanz der DataContractJsonSerializer Klasse, um ein Objekt des angegebenen Typs zu serialisieren oder deserialisieren. Diese Methode gibt auch den Stammnamen des XML-Elements, eine Liste bekannter Typen an, die im Objektdiagramm vorhanden sein können, die maximale Anzahl von Diagrammelementen, die serialisiert oder deserialisiert werden sollen, unabhängig davon, ob unerwartete Daten ignoriert oder Typinformationen ausgegeben werden sollen, und eine Ersatz für die benutzerdefinierte Serialisierung.
DataContractJsonSerializer(Type, String, IEnumerable<Type>)

Initialisiert eine neue Instanz der DataContractJsonSerializer Klasse zum Serialisieren oder Deserialisieren eines Objekts eines angegebenen Typs mithilfe des xml-Stammelements, das durch einen Parameter angegeben wird, mit einer Auflistung bekannter Typen, die im Objektdiagramm vorhanden sein können.
DataContractJsonSerializer(Type, String)

Initialisiert eine neue Instanz der DataContractJsonSerializer Klasse, um ein Objekt eines angegebenen Typs mithilfe des durch einen Parameter angegebenen XML-Stammelements zu serialisieren oder deserialisieren.
DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)

Initialisiert eine neue Instanz der DataContractJsonSerializer Klasse, um ein Objekt des angegebenen Typs zu serialisieren oder deserialisieren. Diese Methode gibt auch den Stammnamen des XML-Elements, eine Liste bekannter Typen an, die im Objektdiagramm vorhanden sein können, die maximale Anzahl von Diagrammelementen, die serialisiert oder deserialisiert werden sollen, unabhängig davon, ob unerwartete Daten ignoriert oder Typinformationen ausgegeben werden sollen, und eine Ersatz für die benutzerdefinierte Serialisierung.
DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>)

Initialisiert eine neue Instanz der DataContractJsonSerializer Klasse zum Serialisieren oder Deserialisieren eines Objekts eines angegebenen Typs mithilfe des XML-Stammelements, das durch einen Parameter vom Typ XmlDictionaryStringangegeben wird, mit einer Auflistung bekannter Typen, die im Objektdiagramm vorhanden sein können.
DataContractJsonSerializer(Type, XmlDictionaryString)

Initialisiert eine neue Instanz der DataContractJsonSerializer Klasse zum Serialisieren oder Deserialisieren eines Objekts eines angegebenen Typs mithilfe des XML-Stammelements, das durch einen Parameter vom Typ XmlDictionaryStringangegeben wird.
DataContractJsonSerializer(Type)

Initialisiert eine neue Instanz der DataContractJsonSerializer Klasse, um ein Objekt des angegebenen Typs zu serialisieren oder deserialisieren.

Eigenschaften

Name Beschreibung
DataContractSurrogate

Ruft einen Ersatztyp ab, der derzeit für eine bestimmte IDataContractSurrogate Instanz aktiv ist. Surrogate können den Serialisierungs- oder Deserialisierungsprozess erweitern.
DateTimeFormat

Ruft das Format der Datums- und Uhrzeittypelemente im Objektdiagramm ab.
EmitTypeInformation

Ruft die JSON-Serialisierungseinstellungen für den Datenvertrag ab, oder legt diese fest, um Typinformationen auszugeben.
IgnoreExtensionDataObject

Ruft einen Wert ab, der angibt, ob unbekannte Daten bei der Deserialisierung ignoriert werden und ob die Schnittstelle bei der IExtensibleDataObject Serialisierung ignoriert wird.
KnownTypes

Ruft eine Auflistung von Typen ab, die mithilfe dieser Instanz des DataContractJsonSerializerObjekts diagramms serialisiert werden können.
MaxItemsInObjectGraph

Ruft die maximale Anzahl von Elementen in einem Objektdiagramm ab, die der Serialisierer in einem Lese- oder Schreibaufruf serialisiert oder deserialisiert.
SerializeReadOnlyTypes

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob schreibgeschützte Typen serialisiert werden sollen.
UseSimpleDictionaryFormat

Ruft einen Wert ab, der angibt, ob ein einfaches Wörterbuchformat verwendet werden soll.

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)

Ruft einen Wert ab, der angibt, ob die XmlDictionaryReader Position über einem XML-Element, das ein Objekt darstellt, von dem der Serialisierer deserialisieren 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 einen Dokumentdatenstrom im JSON-Format (JavaScript Object Notation) und gibt das deserialisierte Objekt zurück.
ReadObject(XmlDictionaryReader, Boolean)

Liest das AUS JSON zugeordnete XML-Dokument mit einem XmlDictionaryReader und gibt das deserialisierte Objekt zurück. Außerdem können Sie angeben, ob der Serialisierer überprüfen soll, ob es für ein entsprechendes Element positioniert ist, bevor versucht wird, die Deserialisierung zu deserialisieren.
ReadObject(XmlDictionaryReader)

Liest das XML-Dokument, das aus JSON (JavaScript Object Notation) zugeordnet ist, mit einem XmlDictionaryReader und gibt das deserialisierte Objekt zurück.
ReadObject(XmlReader, Boolean)

Liest ein AUS JSON zugeordnetes XML-Dokument mit einem XmlReader und gibt das deserialisierte Objekt zurück. Außerdem können Sie angeben, ob der Serialisierer überprüfen soll, ob es für ein entsprechendes Element positioniert ist, bevor versucht wird, deserialisieren.
ReadObject(XmlReader)

Liest das XML-Dokument, das aus JSON (JavaScript Object Notation) zugeordnet ist, 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 in ein XML-Dokument mit einer XmlDictionaryWriter, die JavaScript Object Notation (JSON) zugeordnet werden kann.
WriteEndObject(XmlWriter)

Schreibt das schließende XML-Element in ein XML-Dokument mit einer XmlWriter, die JavaScript Object Notation (JSON) zugeordnet werden kann.
WriteObject(Stream, Object)

Serialisiert ein angegebenes Objekt in JSON-Daten (JavaScript Object Notation) und schreibt den resultierenden JSON-Code in einen Datenstrom.
WriteObject(XmlDictionaryWriter, Object)

Serialisiert ein Objekt in XML, das javaScript Object Notation (JSON) zugeordnet werden kann. Schreibt alle Objektdaten, einschließlich des START-XML-Elements, des Inhalts und des schließende Elements, mit einem XmlDictionaryWriter.
WriteObject(XmlWriter, Object)

Serialisiert ein Objekt in XML, das javaScript Object Notation (JSON) zugeordnet werden kann. Schreibt alle Objektdaten, einschließlich des START-XML-Elements, des Inhalts und des schließende Elements, mit einem XmlWriter.
WriteObjectContent(XmlDictionaryWriter, Object)

Schreibt den XML-Inhalt, der javaScript Object Notation (JSON) mithilfe eines XmlDictionaryWriter.
WriteObjectContent(XmlWriter, Object)

Schreibt den XML-Inhalt, der javaScript Object Notation (JSON) mithilfe eines XmlWriter.
WriteStartObject(XmlDictionaryWriter, Object)

Schreibt das öffnende XML-Element zum Serialisieren eines Objekts in XML, das mit einem XmlDictionaryWriterJSON (JavaScript Object Notation) zugeordnet werden kann.
WriteStartObject(XmlWriter, Object)

Schreibt das öffnende XML-Element zum Serialisieren eines Objekts in XML, das mit einem XmlWriterJSON (JavaScript Object Notation) zugeordnet werden kann.

Gilt für: