JsonSerializerOptions.ReferenceHandler Vlastnost

Definice

Obor názvů:

System.Text.Json

Sestavení:

System.Text.Json.dll

Zdroj:

JsonSerializerOptions.cs

Získá nebo nastaví objekt, který určuje způsob zpracování odkazů na objekt při čtení a zápisu 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

Hodnota vlastnosti

ReferenceHandler

Poznámky

Ve výchozím nastavení serializace nepodporuje objekty s cykly a nezachová duplicitní odkazy. Vlastnosti metadat nebudou zapsány při serializaci referenčních typů a budou považovány za běžné vlastnosti při deserializaci.

• Při serializaci:

  • Zachází s duplicitními odkazy na objekty, jako by byly jedinečné, a zapisuje všechny jejich vlastnosti.
  • Serializátor vyvolá, JsonException pokud objekt obsahuje cyklus.

• Při deserializaci:

  • Vlastnosti metadat ($id, $valuesa $ref) se nebudou využívat, a proto se budou považovat za běžné vlastnosti JSON.
  • Vlastnosti metadat se můžou mapovat na reálnou vlastnost vráceného objektu, pokud se názvy vlastností shodují, nebo budou přidány do slovníku JsonExtensionDataAttribute přetečení, pokud existuje. V opačném případě se ignorují.

Slouží Preserve k povolení zachování jedinečného odkazu na objekt při serializaci a spotřebě metadat ke čtení zachovaných odkazů při deserializaci.