DataContractJsonSerializer DataContractJsonSerializer DataContractJsonSerializer DataContractJsonSerializer Class

Definition

Serialisiert Objekte in die JavaScript Object Notation (JSON) und deserialisiert JSON-Daten zu Objekten.Serializes objects to the JavaScript Object Notation (JSON) and deserializes JSON data to objects. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

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

Hinweise

Verwenden Sie die DataContractJsonSerializer-Klasse, um Instanzen eines Typs in ein JSON-Dokument zu serialisieren und um ein JSON-Dokument in eine Instanz eines Typs zu deserialisieren.Use the DataContractJsonSerializer class to serialize instances of a type into a JSON document and to deserialize a JSON document into an instance of a type. Sie können beispielsweise einen Typ mit dem Namen Person und Eigenschaften erstellen, die wichtige Daten wie Name und Adresse enthalten.For example, you can create a type named Person with properties that contain essential data, such as a name and address. 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.You can then create and manipulate an instance of the Person class and write all of its property values in a JSON document for later retrieval. Dieses JSON-Dokument kann später in die Person-Klasse oder in eine andere Klasse mit einem entsprechenden Datenvertrag deserialisiert werden.This JSON document can later be deserialized into the Person class or another class with an equivalent data contract.

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.If an error occurs during the serialization of an outgoing reply on the server or the reply operation throws an exception for some other reason, it may not get returned to the client as a fault.

Konstruktoren

DataContractJsonSerializer(Type) DataContractJsonSerializer(Type) DataContractJsonSerializer(Type) DataContractJsonSerializer(Type)

Initialisiert eine neue Instanz der DataContractJsonSerializer-Klasse, um ein Objekt des genannten Typs zu serialisieren bzw. zu deserialisieren.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type.

DataContractJsonSerializer(Type, DataContractJsonSerializerSettings) DataContractJsonSerializer(Type, DataContractJsonSerializerSettings) DataContractJsonSerializer(Type, DataContractJsonSerializerSettings) DataContractJsonSerializer(Type, DataContractJsonSerializerSettings)

Initialisiert eine neue Instanz der DataContractJsonSerializer-Klasse, um ein Objekt des genannten Typs und Serialisierungsprogrammeinstellungen zu serialisieren bzw. zu deserialisieren.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type and serializer settings.

DataContractJsonSerializer(Type, IEnumerable<Type>) DataContractJsonSerializer(Type, IEnumerable<Type>) DataContractJsonSerializer(Type, IEnumerable<Type>) 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.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type, with a collection of known types that may be present in the object graph.

DataContractJsonSerializer(Type, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) DataContractJsonSerializer(Type, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) DataContractJsonSerializer(Type, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) 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.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type. 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.This method also specifies a list of known types that may be present in the object graph, the maximum number of graph items to serialize or deserialize, whether to ignore unexpected data or emit type information, and a surrogate for custom serialization.

DataContractJsonSerializer(Type, String) DataContractJsonSerializer(Type, String) DataContractJsonSerializer(Type, String) 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.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of a specified type using the XML root element specified by a parameter.

DataContractJsonSerializer(Type, String, IEnumerable<Type>) DataContractJsonSerializer(Type, String, IEnumerable<Type>) DataContractJsonSerializer(Type, String, IEnumerable<Type>) 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.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of a specified type using the XML root element specified by a parameter, with a collection of known types that may be present in the object graph.

DataContractJsonSerializer(Type, String, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) DataContractJsonSerializer(Type, String, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) DataContractJsonSerializer(Type, String, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) 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.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type. 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.This method also specifies the root name of the XML element, a list of known types that may be present in the object graph, the maximum number of graph items to serialize or deserialize, whether to ignore unexpected data or emit type information, and a surrogate for custom serialization.

DataContractJsonSerializer(Type, XmlDictionaryString) DataContractJsonSerializer(Type, XmlDictionaryString) DataContractJsonSerializer(Type, XmlDictionaryString) 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.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of a specified type using the XML root element specified by a parameter of type XmlDictionaryString.

DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>) DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>) DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>) 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.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of a specified type using the XML root element specified by a parameter of type XmlDictionaryString, with a collection of known types that may be present in the object graph.

DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) 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.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type. 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.This method also specifies the root name of the XML element, a list of known types that may be present in the object graph, the maximum number of graph items to serialize or deserialize, whether to ignore unexpected data or emit type information, and a surrogate for custom serialization.

Eigenschaften

DataContractSurrogate DataContractSurrogate DataContractSurrogate DataContractSurrogate

Ruft einen Ersatzzeichentyp ab, der derzeit für eine angegebene IDataContractSurrogate-Instanz aktiv ist.Gets a surrogate type that is currently active for a given IDataContractSurrogate instance. Ersatzzeichen können den Serialisierungs- oder Deserialisierungsprozess erweitern.Surrogates can extend the serialization or deserialization process.

DateTimeFormat DateTimeFormat DateTimeFormat DateTimeFormat

Ruft das Format der Elemente des Typs Datum/Zeit im Objektdiagramm ab.Gets the format of the date and time type items in object graph.

EmitTypeInformation EmitTypeInformation EmitTypeInformation EmitTypeInformation

Ruft die JSON-Serialisierungseinstellungen für den Datenvertrag zum Ausgeben von Typinformationen ab oder legt diese fest.Gets or sets the data contract JSON serializer settings to emit type information.

IgnoreExtensionDataObject IgnoreExtensionDataObject IgnoreExtensionDataObject 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.Gets a value that specifies whether unknown data is ignored on deserialization and whether the IExtensibleDataObject interface is ignored on serialization.

KnownTypes KnownTypes KnownTypes KnownTypes

Ruft eine Auflistung der Typen in einem Objektdiagramm ab, die mithilfe einer Instanz des DataContractJsonSerializer-Objekts serialisiert werden.Gets a collection of types that may be present in the object graph serialized using this instance of the DataContractJsonSerializer.

MaxItemsInObjectGraph MaxItemsInObjectGraph MaxItemsInObjectGraph MaxItemsInObjectGraph

Ruft die maximale Anzahl von Elementen in einem Objektdiagramm ab, die das Serialisierungsprogramm bei einem Lese- oder Schreibaufruf serialisieren oder deserialisieren kann.Gets the maximum number of items in an object graph that the serializer serializes or deserializes in one read or write call.

SerializeReadOnlyTypes SerializeReadOnlyTypes SerializeReadOnlyTypes SerializeReadOnlyTypes

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob schreibgeschützte Typen serialisiert werden sollen.Gets or sets a value that specifies whether to serialize read only types.

UseSimpleDictionaryFormat UseSimpleDictionaryFormat UseSimpleDictionaryFormat UseSimpleDictionaryFormat

Ruft einen Wert ab, der angibt, ob ein einfaches Wörterbuchformat verwendet werden soll.Gets a value that specifies whether to use a simple dictionary format.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
IsStartObject(XmlDictionaryReader) IsStartObject(XmlDictionaryReader) IsStartObject(XmlDictionaryReader) 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.Gets a value that specifies whether the XmlDictionaryReader is positioned over an XML element that represents an object the serializer can deserialize from.

IsStartObject(XmlReader) IsStartObject(XmlReader) IsStartObject(XmlReader) IsStartObject(XmlReader)

Bestimmt, ob der XmlReader auf einem Objekt positioniert ist, das deserialisiert werden kann.Determines whether the XmlReader is positioned on an object that can be deserialized.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ReadObject(Stream) ReadObject(Stream) ReadObject(Stream) ReadObject(Stream)

Liest einen Dokumentstream im JSON-Format (JavaScript Object Notation) und gibt das deserialisierte Objekt zurück.Reads a document stream in the JSON (JavaScript Object Notation) format and returns the deserialized object.

ReadObject(XmlDictionaryReader) ReadObject(XmlDictionaryReader) ReadObject(XmlDictionaryReader) ReadObject(XmlDictionaryReader)

Liest das aus JSON (JavaScript Object Notation) zugeordnete XML-Dokument mit einem XmlDictionaryReader und gibt das deserialisierte Objekt zurück.Reads the XML document mapped from JSON (JavaScript Object Notation) with an XmlDictionaryReader and returns the deserialized object.

ReadObject(XmlDictionaryReader, Boolean) ReadObject(XmlDictionaryReader, Boolean) ReadObject(XmlDictionaryReader, Boolean) 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.Reads the XML document mapped from JSON with an XmlDictionaryReader and returns the deserialized object; it also enables you to specify whether the serializer should verify that it is positioned on an appropriate element before attempting to deserialize.

ReadObject(XmlReader) ReadObject(XmlReader) ReadObject(XmlReader) ReadObject(XmlReader)

Liest das aus JSON (JavaScript Object Notation) zugeordnete XML-Dokument mit einem XmlReader und gibt das deserialisierte Objekt zurück.Reads the XML document mapped from JSON (JavaScript Object Notation) with an XmlReader and returns the deserialized object.

ReadObject(XmlReader, Boolean) ReadObject(XmlReader, Boolean) ReadObject(XmlReader, Boolean) 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.Reads an XML document mapped from JSON with an XmlReader and returns the deserialized object; it also enables you to specify whether the serializer should verify that it is positioned on an appropriate element before attempting to deserialize.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)
WriteEndObject(XmlDictionaryWriter) WriteEndObject(XmlDictionaryWriter) WriteEndObject(XmlDictionaryWriter) WriteEndObject(XmlDictionaryWriter)

Schreibt das abschließende XML-Element mithilfe eines XmlDictionaryWriter-Objekts in ein XML-Dokument, das JSON (JavaScript Object Notation) zugeordnet werden kann.Writes the closing XML element to an XML document, using an XmlDictionaryWriter, which can be mapped to JavaScript Object Notation (JSON).

WriteEndObject(XmlWriter) WriteEndObject(XmlWriter) WriteEndObject(XmlWriter) WriteEndObject(XmlWriter)

Schreibt das abschließende XML-Element mithilfe eines XmlWriter-Objekts in ein XML-Dokument, das JSON (JavaScript Object Notation) zugeordnet werden kann.Writes the closing XML element to an XML document, using an XmlWriter, which can be mapped to JavaScript Object Notation (JSON).

WriteObject(Stream, Object) WriteObject(Stream, Object) WriteObject(Stream, Object) WriteObject(Stream, Object)

Serialisiert ein angegebenes Objekt in JSON-Daten (JavaScript Object Notation) und schreibt die resultierenden JSON-Daten in einen Stream.Serializes a specified object to JavaScript Object Notation (JSON) data and writes the resulting JSON to a stream.

WriteObject(XmlDictionaryWriter, Object) WriteObject(XmlDictionaryWriter, Object) WriteObject(XmlDictionaryWriter, Object) WriteObject(XmlDictionaryWriter, Object)

Serialisiert ein Objekt in XML, das JSON (JavaScript Object Notation) zugeordnet werden kann.Serializes an object to XML that may be mapped to JavaScript Object Notation (JSON). Schreibt alle Objektdaten, einschließlich des XML-Startelements, des Inhalts und des abschließenden Elements mit einem XmlDictionaryWriter.Writes all the object data, including the starting XML element, content, and closing element, with an XmlDictionaryWriter.

WriteObject(XmlWriter, Object) WriteObject(XmlWriter, Object) WriteObject(XmlWriter, Object) WriteObject(XmlWriter, Object)

Serialisiert ein Objekt in XML, das JSON (JavaScript Object Notation) zugeordnet werden kann.Serializes an object to XML that may be mapped to JavaScript Object Notation (JSON). Schreibt alle Objektdaten, einschließlich des XML-Startelements, des Inhalts und des abschließenden Elements mit einem XmlWriter.Writes all the object data, including the starting XML element, content, and closing element, with an XmlWriter.

WriteObjectContent(XmlDictionaryWriter, Object) WriteObjectContent(XmlDictionaryWriter, Object) WriteObjectContent(XmlDictionaryWriter, Object) WriteObjectContent(XmlDictionaryWriter, Object)

Schreibt den XML-Inhalt, der JSON (JavaScript Object Notation) zugeordnet werden kann, mit einem XmlDictionaryWriter.Writes the XML content that can be mapped to JavaScript Object Notation (JSON) using an XmlDictionaryWriter.

WriteObjectContent(XmlWriter, Object) WriteObjectContent(XmlWriter, Object) WriteObjectContent(XmlWriter, Object) WriteObjectContent(XmlWriter, Object)

Schreibt den XML-Inhalt, der JSON (JavaScript Object Notation) zugeordnet werden kann, mit einem XmlWriter.Writes the XML content that can be mapped to JavaScript Object Notation (JSON) using an XmlWriter.

WriteStartObject(XmlDictionaryWriter, Object) WriteStartObject(XmlDictionaryWriter, Object) WriteStartObject(XmlDictionaryWriter, Object) 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.Writes the opening XML element for serializing an object to XML that can be mapped to JavaScript Object Notation (JSON) using an XmlDictionaryWriter.

WriteStartObject(XmlWriter, Object) WriteStartObject(XmlWriter, Object) WriteStartObject(XmlWriter, Object) 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.Writes the opening XML element for serializing an object to XML that can be mapped to JavaScript Object Notation (JSON) using an XmlWriter.

Gilt für: