JsonSerializerOptions.ReferenceHandler Propriété

Définition

Espace de noms:

System.Text.Json

Assembly:

System.Text.Json.dll

Obtient ou définit un objet qui spécifie comment les références d’objet sont gérées lors de la lecture et de l’écriture de JSON.

public:
 property System::Text::Json::Serialization::ReferenceHandler ^ ReferenceHandler { System::Text::Json::Serialization::ReferenceHandler ^ get(); void set(System::Text::Json::Serialization::ReferenceHandler ^ value); };

public System.Text.Json.Serialization.ReferenceHandler? ReferenceHandler { get; set; }

member this.ReferenceHandler : System.Text.Json.Serialization.ReferenceHandler with get, set

Public Property ReferenceHandler As ReferenceHandler

Valeur de propriété

ReferenceHandler

Remarques

Par défaut, la sérialisation ne prend pas en charge les objets avec des cycles et ne conserve pas les références en double. Les propriétés de métadonnées ne seront pas écrites lors de la sérialisation des types de référence et seront traitées comme des propriétés régulières sur la désérialisation.

• Sur Sérialiser :

  • Traite les références d’objets en double comme si elles étaient uniques et écrivent toutes leurs propriétés.
  • Le sérialiseur lève une JsonException valeur si un objet contient un cycle.

• Sur Désérialiser :

  • Les propriétés de métadonnées ($id, $valueset $ref) ne sont pas consommées et sont donc traitées comme des propriétés JSON régulières.
  • Les propriétés de métadonnées peuvent être mappées à une propriété réelle sur l’objet retourné si les noms des propriétés correspondent, ou seront ajoutées au JsonExtensionDataAttribute dictionnaire de dépassement de capacité, s’il en existe un ; sinon, elles sont ignorées.

Permet Preserve d’activer la conservation unique des références d’objet sur la sérialisation et la consommation de métadonnées pour lire les références conservées sur la désérialisation.