DataContractJsonSerializer Classe

Definizione

Serializza gli oggetti in JSON (JavaScript Object Notation) e deserializza i dati JSON in oggetti.Serializes objects to the JavaScript Object Notation (JSON) and deserializes JSON data to objects. Questa classe non può essere ereditata.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
Ereditarietà
DataContractJsonSerializer

Commenti

Per la maggior parte degli scenari che coinvolgono la serializzazione in JSON e la deserializzazione da JSON, è consigliabile usare gli strumenti nello spazio dei nomi System. Text. JSON.For most scenarios that involve serializing to JSON and deserializing from JSON, we recommend the tools in the System.Text.Json namespace.

Se lo scenario richiede la classe DataContractJsonSerializer, è possibile usarlo per serializzare le istanze di un tipo in un documento JSON e per deserializzare un documento JSON in un'istanza di un tipo.If your scenario requires the DataContractJsonSerializer class, you can use it to serialize instances of a type into a JSON document and to deserialize a JSON document into an instance of a type. Ad esempio, è possibile creare un tipo denominato Person con proprietà che contengono dati essenziali, ad esempio un nome e un indirizzo.For example, you can create a type named Person with properties that contain essential data, such as a name and address. È quindi possibile creare e modificare un'istanza della classe Person e scrivere tutti i valori delle relative proprietà in un documento JSON per il recupero in un secondo momento.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. Tale documento JSON può essere successivamente deserializzato nella classe Person o in un'altra classe con un contratto dati equivalente.This JSON document can later be deserialized into the Person class or another class with an equivalent data contract.

Se si verifica un errore durante la serializzazione di una risposta in uscita nel server o se l'operazione di risposta genera un'eccezione per qualche altro motivo, è possibile che l'errore non venga restituito al client.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.

Costruttori

DataContractJsonSerializer(Type)

Inizializza una nuova istanza della classe DataContractJsonSerializer per serializzare o deserializzare un oggetto del tipo specificato.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type.

DataContractJsonSerializer(Type, DataContractJsonSerializerSettings)

Inizializza una nuova istanza della classe DataContractJsonSerializer per serializzare o deserializzare un oggetto del tipo e delle impostazioni del serializzatore specificati.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>)

Inizializza una nuova istanza della classe DataContractJsonSerializer per serializzare o deserializzare un oggetto del tipo specificato, con una raccolta di tipi noti che possono essere presenti nell'oggetto grafico.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)

Inizializza una nuova istanza della classe DataContractJsonSerializer per serializzare o deserializzare un oggetto del tipo specificato.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type. Questo metodo specifica inoltre un elenco di tipi noti che possono essere presenti nell'oggetto grafico, il numero massimo di elementi dell'oggetto grafico da serializzare o deserializzare, se ignorare i dati imprevisti o generare informazioni sul tipo e un surrogato per la serializzazione personalizzata.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)

Inizializza una nuova istanza della classe DataContractJsonSerializer per serializzare o deserializzare un oggetto di un tipo specificato utilizzando l'elemento radice XML specificato da un parametro.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>)

Inizializza una nuova istanza della classe DataContractJsonSerializer per serializzare o deserializzare un oggetto di un tipo specificato utilizzando l'elemento radice XML specificato da un parametro, con una raccolta di tipi noti che possono essere presenti nell'oggetto grafico.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)

Inizializza una nuova istanza della classe DataContractJsonSerializer per serializzare o deserializzare un oggetto del tipo specificato.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type. Questo metodo specifica inoltre il nome radice dell'elemento XML, un elenco di tipi noti che possono essere presenti nell'oggetto grafico, il numero massimo di elementi dell'oggetto grafico da serializzare o deserializzare, se ignorare i dati imprevisti o generare informazioni sul tipo e un surrogato per la serializzazione personalizzata.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)

Inizializza una nuova istanza della classe DataContractJsonSerializer per serializzare o deserializzare un oggetto di un tipo specificato utilizzando l'elemento radice XML specificato da un parametro di tipo XmlDictionaryString.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>)

Inizializza una nuova istanza della classe DataContractJsonSerializer per serializzare o deserializzare un oggetto di un tipo specificato utilizzando l'elemento radice XML specificato da un parametro di tipo XmlDictionaryString, con una raccolta di tipi noti che possono essere presenti nell'oggetto grafico.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)

Inizializza una nuova istanza della classe DataContractJsonSerializer per serializzare o deserializzare un oggetto del tipo specificato.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type. Questo metodo specifica inoltre il nome radice dell'elemento XML, un elenco di tipi noti che possono essere presenti nell'oggetto grafico, il numero massimo di elementi dell'oggetto grafico da serializzare o deserializzare, se ignorare i dati imprevisti o generare informazioni sul tipo e un surrogato per la serializzazione personalizzata.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.

Proprietà

DataContractSurrogate

Ottiene un tipo surrogato attualmente attivo per una determinata istanza IDataContractSurrogate.Gets a surrogate type that is currently active for a given IDataContractSurrogate instance. I surrogati possono estendere il processo di serializzazione o deserializzazione.Surrogates can extend the serialization or deserialization process.

DateTimeFormat

Ottiene il formato degli elementi di tipo data e ora in un oggetto grafico.Gets the format of the date and time type items in object graph.

EmitTypeInformation

Ottiene o imposta le impostazioni del serializzatore JSON del contratto dati per generare informazioni sul tipo.Gets or sets the data contract JSON serializer settings to emit type information.

IgnoreExtensionDataObject

Ottiene un valore che specifica se i dati sconosciuti vengono ignorati durante la deserializzazione e se l'interfaccia IExtensibleDataObject viene ignorata durante la serializzazione.Gets a value that specifies whether unknown data is ignored on deserialization and whether the IExtensibleDataObject interface is ignored on serialization.

KnownTypes

Ottiene una raccolta di tipi che possono essere presenti nell'oggetto grafico serializzato utilizzando l'istanza di DataContractJsonSerializer.Gets a collection of types that may be present in the object graph serialized using this instance of the DataContractJsonSerializer.

MaxItemsInObjectGraph

Ottiene il numero massimo di elementi in un oggetto grafico che il serializzatore serializza o deserializza in una chiamata di lettura o scrittura.Gets the maximum number of items in an object graph that the serializer serializes or deserializes in one read or write call.

SerializeReadOnlyTypes

Ottiene o imposta un valore che specifica se serializzare i tipi di sola lettura.Gets or sets a value that specifies whether to serialize read only types.

UseSimpleDictionaryFormat

Ottiene un valore che specifica se usare un formato di dizionario semplice.Gets a value that specifies whether to use a simple dictionary format.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
IsStartObject(XmlDictionaryReader)

Ottiene un valore che specifica se la classe XmlDictionaryReader è posizionata su un elemento XML che rappresenta un oggetto da cui il serializzatore può eseguire la deserializzazione.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)

Determina se la classe XmlReader è posizionata su un oggetto che può essere deserializzato.Determines whether the XmlReader is positioned on an object that can be deserialized.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ReadObject(Stream)

Legge un flusso di documenti in formato JSON (JavaScript Object Notation) e restituisce l'oggetto deserializzato.Reads a document stream in the JSON (JavaScript Object Notation) format and returns the deserialized object.

ReadObject(XmlDictionaryReader)

Legge il documento XML mappato da JSON (JavaScript Object Notation) con una classe XmlDictionaryReader e restituisce l'oggetto deserializzato.Reads the XML document mapped from JSON (JavaScript Object Notation) with an XmlDictionaryReader and returns the deserialized object.

ReadObject(XmlDictionaryReader, Boolean)

Legge il documento XML mappato da JSON con una classe XmlDictionaryReader e restituisce l'oggetto deserializzato. Consente inoltre di specificare se il serializzatore deve verificare il corretto posizionamento su un elemento appropriato prima di eseguire il tentativo di serializzazione.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)

Legge il documento XML mappato da JSON (JavaScript Object Notation) con una classe XmlReader e restituisce l'oggetto deserializzato.Reads the XML document mapped from JSON (JavaScript Object Notation) with an XmlReader and returns the deserialized object.

ReadObject(XmlReader, Boolean)

Legge un documento XML mappato da JSON con una classe XmlReader e restituisce l'oggetto deserializzato. Consente inoltre di specificare se il serializzatore deve verificare il corretto posizionamento su un elemento appropriato prima di eseguire il tentativo di serializzazione.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()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
WriteEndObject(XmlDictionaryWriter)

Scrive l'elemento XML di chiusura in un documento XML, utilizzando una classe XmlDictionaryWriter, che può essere mappato a JSON (JavaScript Object Notation).Writes the closing XML element to an XML document, using an XmlDictionaryWriter, which can be mapped to JavaScript Object Notation (JSON).

WriteEndObject(XmlWriter)

Scrive l'elemento XML di chiusura in un documento XML, utilizzando una classe XmlWriter, che può essere mappato a JSON (JavaScript Object Notation).Writes the closing XML element to an XML document, using an XmlWriter, which can be mapped to JavaScript Object Notation (JSON).

WriteObject(Stream, Object)

Serializza un oggetto specificato in dati JSON (JavaScript Object Notation) e scrive il risultato JSON in un flusso.Serializes a specified object to JavaScript Object Notation (JSON) data and writes the resulting JSON to a stream.

WriteObject(XmlDictionaryWriter, Object)

Serializza un oggetto in XML che può essere mappato a JSON (JavaScript Object Notation).Serializes an object to XML that may be mapped to JavaScript Object Notation (JSON). Scrive tutti i dati dell'oggetto, inclusi l'elemento XML di apertura, il contenuto e l'elemento di chiusura, con una classe XmlDictionaryWriter.Writes all the object data, including the starting XML element, content, and closing element, with an XmlDictionaryWriter.

WriteObject(XmlWriter, Object)

Serializza un oggetto in XML che può essere mappato a JSON (JavaScript Object Notation).Serializes an object to XML that may be mapped to JavaScript Object Notation (JSON). Scrive tutti i dati dell'oggetto, inclusi l'elemento XML di apertura, il contenuto e l'elemento di chiusura, con una classe XmlWriter.Writes all the object data, including the starting XML element, content, and closing element, with an XmlWriter.

WriteObjectContent(XmlDictionaryWriter, Object)

Scrive il contenuto XML che può essere mappato a JSON (JavaScript Object Notation) utilizzando la classe XmlDictionaryWriter.Writes the XML content that can be mapped to JavaScript Object Notation (JSON) using an XmlDictionaryWriter.

WriteObjectContent(XmlWriter, Object)

Scrive il contenuto XML che può essere mappato a JSON (JavaScript Object Notation) utilizzando la classe XmlWriter.Writes the XML content that can be mapped to JavaScript Object Notation (JSON) using an XmlWriter.

WriteStartObject(XmlDictionaryWriter, Object)

Scrive l'elemento XML di apertura per la serializzazione di un oggetto in XML che può essere mappato a JSON (JavaScript Object Notation) utilizzando una classe XmlDictionaryWriter.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)

Scrive l'elemento XML di apertura per la serializzazione di un oggetto in XML che può essere mappato a JSON (JavaScript Object Notation) utilizzando una classe XmlWriter.Writes the opening XML element for serializing an object to XML that can be mapped to JavaScript Object Notation (JSON) using an XmlWriter.

Si applica a