JsonSerializerOptions.ReferenceHandler Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
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
,$values
a$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í.
- Vlastnosti metadat (
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.