DataContractJsonSerializer Klasse

Referenz

Definition

Namespace:: System.Runtime.Serialization.Json

Assembly:: System.Runtime.Serialization.Json.dll

Assembly:: System.ServiceModel.Web.dll

Assembly:: System.Runtime.Serialization.dll

Assembly:: netstandard.dll

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 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: Object
DataContractJsonSerializer

Vererbung: Object

XmlObjectSerializer
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 eine 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: