DataContractJsonSerializer Classe

Definizione

Spazio dei nomi:
System.Runtime.Serialization.Json
Assembly:
System.Runtime.Serialization.dll, System.Runtime.Serialization.Json.dll
Assembly:
System.ServiceModel.Web.dll
Assembly:
System.Runtime.Serialization.dll
Assembly:
netstandard.dll

Serializza gli oggetti in JavaScript Object Notation (JSON) e deserializza i dati JSON negli 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à
Object
DataContractJsonSerializer
Ereditarietà
Object
XmlObjectSerializer
DataContractJsonSerializer

Commenti

Per la maggior parte degli scenari che comportano la serializzazione in JSON e la 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 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 Person classe e scrivere tutti i relativi valori di proprietà in un documento JSON per il recupero successivo. Questo documento JSON può essere deserializzato in un secondo momento nella Person classe 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 l'operazione di risposta genera un'eccezione per un altro motivo, potrebbe non essere restituito al client come errore.

Costruttori

Nome Descrizione
DataContractJsonSerializer(Type, DataContractJsonSerializerSettings)

Inizializza una nuova istanza della DataContractJsonSerializer classe per serializzare o deserializzare un oggetto delle impostazioni del tipo e del serializzatore specificati.
DataContractJsonSerializer(Type, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)

Inizializza una nuova istanza della DataContractJsonSerializer classe per serializzare o deserializzare un oggetto del tipo specificato. Questo metodo specifica anche un elenco di tipi noti che possono essere presenti nell'oggetto grafico, il numero massimo di elementi del grafo da serializzare o deserializzare, se ignorare i dati imprevisti o generare informazioni sul tipo e un surrogato per la serializzazione personalizzata.
DataContractJsonSerializer(Type, IEnumerable<Type>)

Inizializza una nuova istanza della DataContractJsonSerializer classe per serializzare o deserializzare un oggetto del tipo specificato, 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 DataContractJsonSerializer classe per serializzare o deserializzare un oggetto del tipo specificato. Questo metodo specifica anche il nome radice dell'elemento XML, un elenco di tipi noti che possono essere presenti nell'oggetto grafico, il numero massimo di elementi del 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, IEnumerable<Type>)

Inizializza una nuova istanza della DataContractJsonSerializer classe 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)

Inizializza una nuova istanza della DataContractJsonSerializer classe per serializzare o deserializzare un oggetto di un tipo specificato utilizzando l'elemento radice XML specificato da un parametro.
DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)

Inizializza una nuova istanza della DataContractJsonSerializer classe per serializzare o deserializzare un oggetto del tipo specificato. Questo metodo specifica anche il nome radice dell'elemento XML, un elenco di tipi noti che possono essere presenti nell'oggetto grafico, il numero massimo di elementi del 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, IEnumerable<Type>)

Inizializza una nuova istanza della DataContractJsonSerializer classe 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)

Inizializza una nuova istanza della DataContractJsonSerializer classe per serializzare o deserializzare un oggetto di un tipo specificato utilizzando l'elemento radice XML specificato da un parametro di tipo XmlDictionaryString.
DataContractJsonSerializer(Type)

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

Proprietà

Nome Descrizione
DataContractSurrogate

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

Ottiene il formato degli elementi del tipo di data e ora nell'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 viene ignorata durante la IExtensibleDataObject serializzazione.
KnownTypes

Ottiene una raccolta di tipi che possono essere presenti nel grafico dell'oggetto serializzato utilizzando questa istanza di DataContractJsonSerializer.
MaxItemsInObjectGraph

Ottiene il numero massimo di elementi in un oggetto grafico serializzatore 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 utilizzare un formato di dizionario semplice.

Metodi

Nome Descrizione
Equals(Object)

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

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
IsStartObject(XmlDictionaryReader)

Ottiene un valore che specifica se l'oggetto XmlDictionaryReader è posizionato su un elemento XML che rappresenta un oggetto da cui il serializzatore può deserializzare.
IsStartObject(XmlReader)

Determina se l'oggetto XmlReader è posizionato su un oggetto che può essere deserializzato.
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
ReadObject(Stream)

Legge un flusso di documenti nel formato JSON (JavaScript Object Notation) e restituisce l'oggetto deserializzato.
ReadObject(XmlDictionaryReader, Boolean)

Legge il documento XML mappato da JSON con un XmlDictionaryReader oggetto e restituisce l'oggetto deserializzato. Consente inoltre di specificare se il serializzatore deve verificare che sia posizionato su un elemento appropriato prima di tentare di deserializzare.
ReadObject(XmlDictionaryReader)

Legge il documento XML mappato da JSON (JavaScript Object Notation) con un oggetto XmlDictionaryReader e restituisce l'oggetto deserializzato.
ReadObject(XmlReader, Boolean)

Legge un documento XML mappato da JSON con un XmlReader oggetto e restituisce l'oggetto deserializzato. Consente inoltre di specificare se il serializzatore deve verificare che sia posizionato su un elemento appropriato prima di tentare di deserializzare.
ReadObject(XmlReader)

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

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
WriteEndObject(XmlDictionaryWriter)

Scrive l'elemento XML di chiusura in un documento XML, usando un XmlDictionaryWriteroggetto , che può essere mappato a JavaScript Object Notation (JSON).
WriteEndObject(XmlWriter)

Scrive l'elemento XML di chiusura in un documento XML, usando un XmlWriteroggetto , che può essere mappato a JavaScript Object Notation (JSON).
WriteObject(Stream, Object)

Serializza un oggetto specificato in dati JSON (JavaScript Object Notation) e scrive il codice JSON risultante in un flusso.
WriteObject(XmlDictionaryWriter, Object)

Serializza un oggetto in XML di cui è possibile eseguire il mapping a JSON (JavaScript Object Notation). Scrive tutti i dati dell'oggetto, inclusi l'elemento XML iniziale, il contenuto e l'elemento di chiusura, con un oggetto XmlDictionaryWriter.
WriteObject(XmlWriter, Object)

Serializza un oggetto in XML di cui è possibile eseguire il mapping a JSON (JavaScript Object Notation). Scrive tutti i dati dell'oggetto, inclusi l'elemento XML iniziale, il contenuto e l'elemento di chiusura, con un oggetto XmlWriter.
WriteObjectContent(XmlDictionaryWriter, Object)

Scrive il contenuto XML di cui è possibile eseguire il mapping a JSON (JavaScript Object Notation) usando un oggetto XmlDictionaryWriter.
WriteObjectContent(XmlWriter, Object)

Scrive il contenuto XML di cui è possibile eseguire il mapping a JSON (JavaScript Object Notation) usando un oggetto XmlWriter.
WriteStartObject(XmlDictionaryWriter, Object)

Scrive l'elemento XML di apertura per serializzare un oggetto in XML di cui è possibile eseguire il mapping a JavaScript Object Notation (JSON) usando un oggetto XmlDictionaryWriter.
WriteStartObject(XmlWriter, Object)

Scrive l'elemento XML di apertura per serializzare un oggetto in XML di cui è possibile eseguire il mapping a JavaScript Object Notation (JSON) usando un oggetto XmlWriter.

Si applica a