Freigeben über


DataContractJsonSerializer Klasse

Definition

Serialisiert Objekte in die JavaScript Object Notation (JSON) und deserialisiert JSON-Daten zu 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
DataContractJsonSerializer
Vererbung
DataContractJsonSerializer

Hinweise

Für die meisten Szenarien, in denen die Serialisierung in JSON und die Deserialisierung aus JSON erforderlich sind, empfehlen wir die APIs im System.Text.Json-Namespace.

Wenn Ihr Szenario die DataContractJsonSerializer -Klasse erfordert, können Sie sie verwenden, um Instanzen eines Typs in ein JSON-Dokument zu serialisieren und ein JSON-Dokument in einem instance eines Typs zu deserialisieren. Sie können beispielsweise einen Typ mit dem Namen Person und Eigenschaften erstellen, die wichtige Daten wie Name und Adresse enthalten. Anschließend haben Sie die Möglichkeit, eine Instanz der Person-Klasse zu erstellen und zu bearbeiten sowie alle Eigenschaftenwerte für den späteren Abruf in ein JSON-Dokument zu schreiben. Dieses JSON-Dokument kann später in die Person-Klasse oder in eine andere Klasse mit einem entsprechenden Datenvertrag deserialisiert werden.

Wenn bei der Serialisierung einer ausgehenden Antwort auf dem Server ein Fehler auftritt oder wenn der Antwortvorgang aus einem anderen Grund eine Ausnahme auslöst, wird möglicherweise kein Fehler an den Client zurückgegeben.

Konstruktoren

DataContractJsonSerializer(Type)

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

DataContractJsonSerializer(Type, DataContractJsonSerializerSettings)

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

DataContractJsonSerializer(Type, IEnumerable<Type>)

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

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

Initialisiert eine neue Instanz der DataContractJsonSerializer-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, die maximale Anzahl von zu serialisierenden bzw. zu deserialisierenden Diagrammelementen sowie ein Ersatzzeichen für die benutzerspezifische Serialisierung. Weiterhin kennzeichnet sie, ob nicht erwartete Daten ignoriert werden sollen oder ob Typinformationen ausgegeben werden sollen.

DataContractJsonSerializer(Type, String)

Initialisiert eine neue Instanz der DataContractJsonSerializer-Klasse, um ein Objekt des genannten Typs mithilfe des durch einen Parameter angegebenen XML-Stammelements zu serialisieren bzw. zu deserialisieren.

DataContractJsonSerializer(Type, String, IEnumerable<Type>)

Initialisiert eine neue Instanz der DataContractJsonSerializer-Klasse, um ein Objekt des genannten Typs mithilfe des durch einen Parameter angegebenen XML-Stammelements und mit einer Auflistung bekannter Typen, die ggf. im Objektdiagramm vorhanden sind, zu serialisieren bzw. zu deserialisieren.

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

Initialisiert eine neue Instanz der DataContractJsonSerializer-Klasse, um ein Objekt des genannten Typs zu serialisieren bzw. zu deserialisieren. Diese Methode nennt zudem den Namen des XML-Stammelements, eine Liste bekannter Typen, die ggf. im Objektdiagramm enthalten sind, die maximale Anzahl von zu serialisierenden bzw. zu deserialisierenden Diagrammelementen sowie ein Ersatzzeichen für die benutzerspezifische Serialisierung. Weiterhin kennzeichnet sie, ob nicht erwartete Daten ignoriert werden sollen oder ob Typinformationen ausgegeben werden sollen.

DataContractJsonSerializer(Type, XmlDictionaryString)

Initialisiert eine neue Instanz der DataContractJsonSerializer-Klasse, um ein Objekt des genannten Typs mithilfe des durch einen XmlDictionaryString-Parameter angegebenen XML-Stammelements zu serialisieren bzw. zu deserialisieren.

DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>)

Initialisiert eine neue Instanz der DataContractJsonSerializer-Klasse, um ein Objekt des genannten Typs mithilfe des durch einen XmlDictionaryString-Parameter angegebenen XML-Stammelements und mit einer Auflistung bekannter Typen, die ggf. im Objektdiagramm vorhanden sind, zu serialisieren bzw. zu deserialisieren.

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

Initialisiert eine neue Instanz der DataContractJsonSerializer-Klasse, um ein Objekt des genannten Typs zu serialisieren bzw. zu deserialisieren. Diese Methode nennt zudem den Namen des XML-Stammelements, eine Liste bekannter Typen, die ggf. im Objektdiagramm enthalten sind, die maximale Anzahl von zu serialisierenden bzw. zu deserialisierenden Diagrammelementen sowie ein Ersatzzeichen für die benutzerspezifische Serialisierung. Weiterhin kennzeichnet sie, ob nicht erwartete Daten ignoriert werden sollen oder ob Typinformationen ausgegeben werden sollen.

Eigenschaften

DataContractSurrogate

Ruft einen Ersatzzeichentyp ab, der derzeit für eine angegebene IDataContractSurrogate-Instanz aktiv ist. Ersatzzeichen können den Serialisierungs- oder Deserialisierungsprozess erweitern.

DateTimeFormat

Ruft das Format der Elemente des Typs Datum/Zeit im Objektdiagramm ab.

EmitTypeInformation

Ruft die JSON-Serialisierungseinstellungen für den Datenvertrag zum Ausgeben von Typinformationen ab oder legt diese fest.

IgnoreExtensionDataObject

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

KnownTypes

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

MaxItemsInObjectGraph

Ruft die maximale Anzahl von Elementen in einem Objektdiagramm ab, die das Serialisierungsprogramm bei einem Lese- oder Schreibaufruf serialisieren oder deserialisieren kann.

SerializeReadOnlyTypes

Ruft einen Wert ab oder legt einen Wert fest, 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

Equals(Object)

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

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetSerializationSurrogateProvider()

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

GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
IsStartObject(XmlDictionaryReader)

Ruft einen Wert ab, der angibt, ob der XmlDictionaryReader auf einem XML-Element positioniert ist und ob es sich dabei um ein Objekt handelt, von dem aus das Serialisierungsprogramm deserialisieren 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 einen Dokumentstream im JSON-Format (JavaScript Object Notation) und gibt das deserialisierte Objekt zurück.

ReadObject(XmlDictionaryReader)

Liest das aus JSON (JavaScript Object Notation) zugeordnete XML-Dokument mit einem XmlDictionaryReader 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. Sie können zudem angeben, ob das Serialisierungsprogramm vor der Deserialisierung überprüfen soll, ob der Reader auf einem geeigneten Element positioniert ist.

ReadObject(XmlReader)

Liest das aus JSON (JavaScript Object Notation) zugeordnete XML-Dokument mit einem XmlReader 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. Sie können zudem angeben, ob das Serialisierungsprogramm vor der Deserialisierung überprüfen soll, ob der Reader auf einem geeigneten Element positioniert ist.

SetSerializationSurrogateProvider(ISerializationSurrogateProvider)

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

ToString()

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

(Geerbt von Object)
WriteEndObject(XmlDictionaryWriter)

Schreibt das abschließende XML-Element mithilfe eines XmlDictionaryWriter-Objekts in ein XML-Dokument, das JSON (JavaScript Object Notation) zugeordnet werden kann.

WriteEndObject(XmlWriter)

Schreibt das abschließende XML-Element mithilfe eines XmlWriter-Objekts in ein XML-Dokument, das JSON (JavaScript Object Notation) zugeordnet werden kann.

WriteObject(Stream, Object)

Serialisiert ein angegebenes Objekt in JSON-Daten (JavaScript Object Notation) und schreibt die resultierenden JSON-Daten in einen Stream.

WriteObject(XmlDictionaryWriter, Object)

Serialisiert ein Objekt in XML, das JSON (JavaScript Object Notation) zugeordnet werden kann. Schreibt alle Objektdaten, einschließlich des XML-Startelements, des Inhalts und des abschließenden Elements mit einem XmlDictionaryWriter.

WriteObject(XmlWriter, Object)

Serialisiert ein Objekt in XML, das JSON (JavaScript Object Notation) zugeordnet werden kann. Schreibt alle Objektdaten, einschließlich des XML-Startelements, des Inhalts und des abschließenden Elements mit einem XmlWriter.

WriteObjectContent(XmlDictionaryWriter, Object)

Schreibt den XML-Inhalt, der JSON (JavaScript Object Notation) zugeordnet werden kann, mit einem XmlDictionaryWriter.

WriteObjectContent(XmlWriter, Object)

Schreibt den XML-Inhalt, der JSON (JavaScript Object Notation) zugeordnet werden kann, mit einem XmlWriter.

WriteStartObject(XmlDictionaryWriter, Object)

Schreibt mit einem XmlDictionaryWriter das öffnende XML-Element für die Serialisierung eines Objekts in XML, das JSON (JavaScript Object Notation) zugeordnet werden kann.

WriteStartObject(XmlWriter, Object)

Schreibt mit einem XmlWriter das öffnende XML-Element für die Serialisierung eines Objekts in XML, das JSON (JavaScript Object Notation) zugeordnet werden kann.

Gilt für: