Condividi tramite


JsonSerializerOptions Classe

Definizione

Fornisce opzioni da usare con JsonSerializer.

public ref class JsonSerializerOptions sealed
public sealed class JsonSerializerOptions
type JsonSerializerOptions = class
Public NotInheritable Class JsonSerializerOptions
Ereditarietà
JsonSerializerOptions

Commenti

Per altre informazioni, vedere Come serializzare e deserializzare JSON.

Costruttori

JsonSerializerOptions()

Inizializza una nuova istanza della classe JsonSerializerOptions.

JsonSerializerOptions(JsonSerializerDefaults)

Costruisce una nuova istanza JsonSerializerOptions con un set predefinito di opzioni determinato dall'JsonSerializerDefaultsspecificato.

JsonSerializerOptions(JsonSerializerOptions)

Copia le opzioni da un'istanza di JsonSerializerOptions in una nuova istanza.

Proprietà

AllowOutOfOrderMetadataProperties

Consente di specificare le proprietà dei metadati JSON dopo le normali proprietà in un oggetto JSON deserializzato.

AllowTrailingCommas

Ottiene o imposta un valore che indica se una virgola aggiuntiva alla fine di un elenco di valori JSON in un oggetto o matrice è consentita (e ignorata) all'interno del payload JSON da deserializzare.

Converters

Ottiene l'elenco dei convertitori definiti dall'utente registrati.

Default

Ottiene un'istanza singleton di sola lettura di JsonSerializerOptions che usa la configurazione predefinita.

DefaultBufferSize

Ottiene o imposta le dimensioni predefinite del buffer, in byte, da utilizzare durante la creazione di buffer temporanei.

DefaultIgnoreCondition

Ottiene o imposta un valore che determina quando le proprietà con valori predefiniti vengono ignorate durante la serializzazione o la deserializzazione. Il valore predefinito è Never.

DictionaryKeyPolicy

Ottiene o imposta i criteri utilizzati per convertire il nome di una chiave IDictionary in un altro formato, ad esempio la combinazione di maiuscole e minuscole.

Encoder

Ottiene o imposta il codificatore da utilizzare durante l'escape di stringhe o null per usare il codificatore predefinito.

IgnoreNullValues
Obsoleti.

Ottiene o imposta un valore che indica se null valori vengono ignorati durante la serializzazione e la deserializzazione. Il valore predefinito è false.

IgnoreReadOnlyFields

Ottiene o imposta un valore che indica se i campi di sola lettura vengono ignorati durante la serializzazione. Un campo è di sola lettura se è contrassegnato con la parola chiave readonly. Il valore predefinito è false.

IgnoreReadOnlyProperties

Ottiene un valore che indica se le proprietà di sola lettura vengono ignorate durante la serializzazione. Il valore predefinito è false.

IncludeFields

Ottiene o imposta un valore che indica se i campi vengono gestiti durante la serializzazione e la deserializzazione. Il valore predefinito è false.

IndentCharacter

Definisce il carattere di rientro utilizzato quando WriteIndented è abilitato. Il valore predefinito è lo spazio.

IndentSize

Definisce le dimensioni del rientro utilizzate quando WriteIndented è abilitato. Il valore predefinito è due.

IsReadOnly

Ottiene un valore che indica se l'istanza corrente è stata bloccata per la modifica dell'utente.

MaxDepth

Ottiene o imposta la profondità massima consentita durante la serializzazione o la deserializzazione di JSON, con il valore predefinito 0 che indica una profondità massima di 64.

NewLine

Ottiene o imposta la nuova stringa di riga da utilizzare quando WriteIndented è true.

Il valore predefinito è il valore di NewLine.

NumberHandling

Ottiene o imposta un oggetto che specifica la modalità di gestione dei tipi di numero durante la serializzazione o la deserializzazione.

PreferredObjectCreationHandling

Ottiene o imposta la gestione preferita per la creazione di oggetti per le proprietà durante la deserializzazione di JSON.

PropertyNameCaseInsensitive

Ottiene o imposta un valore che indica se il nome di una proprietà utilizza un confronto senza distinzione tra maiuscole e minuscole durante la deserializzazione. Il valore predefinito è false.

PropertyNamingPolicy

Ottiene o imposta un valore che specifica i criteri utilizzati per convertire il nome di una proprietà in un oggetto in un altro formato, ad esempio camel-maiuscole o null per lasciare invariati i nomi delle proprietà.

ReadCommentHandling

Ottiene o imposta un valore che definisce la modalità di gestione dei commenti durante la deserializzazione.

ReferenceHandler

Ottiene o imposta un oggetto che specifica la modalità di gestione dei riferimenti agli oggetti durante la lettura e la scrittura di JSON.

RespectNullableAnnotations

Ottiene o imposta un valore che indica se le annotazioni nullbility devono essere rispettate durante la serializzazione e la deserializzazione.

RespectRequiredConstructorParameters

Ottiene o imposta un valore che indica se i parametri del costruttore non facoltativi devono essere specificati durante la deserializzazione.

TypeInfoResolver

Ottiene o imposta il resolver del contratto JsonTypeInfo utilizzato da questa istanza.

TypeInfoResolverChain

Ottiene l'elenco dei resolver del contratto di JsonTypeInfo concatenati utilizzati da questa istanza.

UnknownTypeHandling

Ottiene o imposta un oggetto che specifica come deserializzare un tipo dichiarato come Object viene gestito durante la deserializzazione.

UnmappedMemberHandling

Ottiene o imposta un oggetto che specifica come JsonSerializer gestisce le proprietà JSON di cui non è possibile eseguire il mapping a un membro .NET specifico durante la deserializzazione dei tipi di oggetto.

Web

Ottiene un'istanza singleton di sola lettura di JsonSerializerOptions che usa la configurazione Web.

WriteIndented

Ottiene o imposta un valore che indica se JSON deve usare una stampa piuttosto semplice. Per impostazione predefinita, JSON viene serializzato senza spazi vuoti aggiuntivi.

Metodi

AddContext<TContext>()
Obsoleti.

Aggiunge una nuova JsonSerializerContext alla risoluzione dei metadati dell'istanza di JsonSerializerOptions corrente.

Equals(Object)

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

(Ereditato da Object)
GetConverter(Type)

Restituisce il convertitore per il tipo specificato.

GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
GetTypeInfo(Type)

Ottiene i metadati del contratto JsonTypeInfo risolti dall'istanza di JsonSerializerOptions corrente.

MakeReadOnly()

Contrassegna l'istanza corrente come di sola lettura per impedire ulteriori modifiche dell'utente.

MakeReadOnly(Boolean)

Contrassegna l'istanza corrente come di sola lettura che impedisce ulteriori modifiche dell'utente.

MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
TryGetTypeInfo(Type, JsonTypeInfo)

Tenta di ottenere i metadati del contratto di JsonTypeInfo risolti dall'istanza di JsonSerializerOptions corrente.

Metodi di estensione

GetJsonSchemaAsNode(JsonSerializerOptions, Type, JsonSchemaExporterOptions)

Ottiene lo schema JSON per type come documento di JsonNode.

Si applica a