DataContractJsonSerializer Classe

Definizione

Serializza gli oggetti in JSON (JavaScript Object Notation) e deserializza i dati JSON in oggetti. La classe non può essere ereditata.

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
Ereditarietà
DataContractJsonSerializer
Ereditarietà
DataContractJsonSerializer

Commenti

Per la maggior parte degli scenari che comportano la serializzazione in JSON e deserializzazione da JSON, è consigliabile usare le API nello spazio dei nomi System.Text.Json.

Se lo scenario richiede la DataContractJsonSerializer classe, è possibile usarla per serializzare le istanze di un tipo in un documento JSON e deserializzare un documento JSON in un'istanza di un tipo. Ad esempio, è possibile creare un tipo denominato Person con proprietà che contengono dati essenziali, ad esempio un nome e un indirizzo. È 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. Tale documento JSON può essere successivamente deserializzato nella classe Person o in un'altra classe con un contratto dati equivalente.

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.

Costruttori

DataContractJsonSerializer(Type)

Inizializza una nuova istanza della classe DataContractJsonSerializer per serializzare o deserializzare un oggetto del tipo specificato.

DataContractJsonSerializer(Type, DataContractJsonSerializerSettings)

Inizializza una nuova istanza della classe DataContractJsonSerializer per serializzare o deserializzare un oggetto del tipo e delle impostazioni del serializzatore specificati.

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.

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

Inizializza una nuova istanza della classe DataContractJsonSerializer per serializzare o deserializzare un oggetto del tipo specificato. 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.

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.

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.

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. 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.

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.

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.

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. 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.

Proprietà

DataContractSurrogate

Ottiene un tipo surrogato attualmente attivo per una determinata istanza IDataContractSurrogate. I surrogati possono estendere il processo di serializzazione o deserializzazione.

DateTimeFormat

Ottiene il formato degli elementi di tipo data e ora in un oggetto grafico.

EmitTypeInformation

Ottiene o imposta le impostazioni del serializzatore JSON del contratto dati per generare informazioni sul tipo.

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.

KnownTypes

Ottiene una raccolta di tipi che possono essere presenti nell'oggetto grafico serializzato utilizzando l'istanza di 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.

SerializeReadOnlyTypes

Ottiene o imposta un valore che specifica se serializzare i tipi di sola lettura.

UseSimpleDictionaryFormat

Ottiene un valore che specifica se usare un formato di dizionario semplice.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetSerializationSurrogateProvider()

Serializza gli oggetti in JSON (JavaScript Object Notation) e deserializza i dati JSON in oggetti. La classe non può essere ereditata.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(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.

IsStartObject(XmlReader)

Determina se la classe XmlReader è posizionata su un oggetto che può essere deserializzato.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ReadObject(Stream)

Legge un flusso di documenti in formato JSON (JavaScript Object Notation) e restituisce l'oggetto deserializzato.

ReadObject(XmlDictionaryReader)

Legge il documento XML mappato da JSON (JavaScript Object Notation) con una classe XmlDictionaryReader e restituisce l'oggetto deserializzato.

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.

ReadObject(XmlReader)

Legge il documento XML mappato da JSON (JavaScript Object Notation) con una classe XmlReader e restituisce l'oggetto deserializzato.

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.

SetSerializationSurrogateProvider(ISerializationSurrogateProvider)

Serializza gli oggetti in JSON (JavaScript Object Notation) e deserializza i dati JSON in oggetti. La classe non può essere ereditata.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(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).

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).

WriteObject(Stream, Object)

Serializza un oggetto specificato in dati JSON (JavaScript Object Notation) e scrive il risultato JSON in un flusso.

WriteObject(XmlDictionaryWriter, Object)

Serializza un oggetto in XML che può essere mappato a JSON (JavaScript Object Notation). Scrive tutti i dati dell'oggetto, inclusi l'elemento XML di apertura, il contenuto e l'elemento di chiusura, con una classe XmlDictionaryWriter.

WriteObject(XmlWriter, Object)

Serializza un oggetto in XML che può essere mappato a JSON (JavaScript Object Notation). Scrive tutti i dati dell'oggetto, inclusi l'elemento XML di apertura, il contenuto e l'elemento di chiusura, con una classe XmlWriter.

WriteObjectContent(XmlDictionaryWriter, Object)

Scrive il contenuto XML che può essere mappato a JSON (JavaScript Object Notation) utilizzando la classe XmlDictionaryWriter.

WriteObjectContent(XmlWriter, Object)

Scrive il contenuto XML che può essere mappato a JSON (JavaScript Object Notation) utilizzando la classe 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.

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.

Si applica a