ReferenceHandler.Preserve Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Text.Json.Serialization
Assembly:
System.Text.Json.dll
Pacchetto:
System.Text.Json v8.0.5
Pacchetto:
System.Text.Json v9.0.0-rc.2.24473.5
Origine:
ReferenceHandler.cs
Origine:
ReferenceHandler.cs
Origine:
ReferenceHandler.cs

Ottiene un oggetto che indica se le proprietà dei metadati vengono rispettate quando gli oggetti JSON e le matrici vengono deserializzati in tipi di riferimento e scritti quando vengono serializzati i tipi di riferimento. Questa operazione è necessaria per creare un file JSON di cui è possibile eseguire il round-trip da oggetti che contengono cicli o riferimenti duplicati.

public:
 static property System::Text::Json::Serialization::ReferenceHandler ^ Preserve { System::Text::Json::Serialization::ReferenceHandler ^ get(); };
public static System.Text.Json.Serialization.ReferenceHandler Preserve { get; }
static member Preserve : System.Text.Json.Serialization.ReferenceHandler
Public Shared ReadOnly Property Preserve As ReferenceHandler

Valore della proprietà

ReferenceHandler

Commenti

  • In Serializzare:

    • Quando si scrivono tipi di riferimento complessi, il serializzatore scrive anche proprietà dei metadati ($id, $valuese $ref) all'interno di essi.
    • Il codice JSON di output conterrà una proprietà aggiuntiva $id per ogni oggetto e per ogni tipo enumerabile che verrà annidato all'interno di un oggetto JSON contenente una $id proprietà e $values .
    • ReferenceEquals(Object, Object) viene usato per determinare se gli oggetti sono identici.
    • Quando un oggetto è identico a quello serializzato in precedenza, viene scritto un puntatore () all'identificatore ($ref$id) di tale oggetto.
    • Nessuna proprietà dei metadati viene scritta per i tipi di valore.

  • In Deserialize:

    • Le proprietà dei metadati all'interno del codice JSON che vengono usate per mantenere i riferimenti duplicati e i cicli verranno onorati purché siano ben formati.*
    • Per gli oggetti JSON che non contengono proprietà dei metadati, il comportamento di deserializzazione è identico a non usare Preserve.
    • Per i tipi di valore, la $id proprietà dei metadati viene ignorata. Viene JsonException generato se viene trovata una $ref proprietà di metadati all'interno dell'oggetto JSON.
    • Per i tipi di valore enumerabili, la $values proprietà dei metadati viene ignorata.

  • Per le proprietà dei metadati all'interno del file JSON da considerare ben formate, devono seguire queste regole:

    • La $id proprietà dei metadati deve essere la prima proprietà nell'oggetto JSON.
    • Un oggetto JSON che contiene una $ref proprietà di metadati non deve contenere altre proprietà.
    • Il valore della $ref proprietà dei metadati deve fare riferimento a un $id oggetto che è apparso in precedenza in JSON.
    • Il valore delle proprietà e $ref dei $id metadati deve essere una stringa JSON.
    • Per i tipi enumerabili, ad esempio List<T>, la matrice JSON deve essere annidata all'interno di un oggetto JSON contenente una $id proprietà e $values metadati, in tale ordine.
    • Per i tipi enumerabili, la $values proprietà dei metadati deve essere una matrice JSON.
    • La $values proprietà dei metadati è valida solo quando si fa riferimento a tipi enumerabili.

Se il codice JSON non è ben formato, viene generato un JsonException oggetto .

Si applica a