JsonSerializerOptions.ReferenceHandler Vlastnost

Definice

Obor názvů:

System.Text.Json

Sestavení:

System.Text.Json.dll

Balíček:

System.Text.Json v11.0.0-preview.5.26302.115

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 odkazových typů a budou považovány za běžné vlastnosti při deserializaci.

• Při serializaci:

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

• Při deserializaci:

  • Vlastnosti metadat ($id, $valuesa $ref) nebudou spotřebovány, a proto se budou považovat za běžné vlastnosti JSON.
  • Vlastnosti metadat se můžou mapovat na skutečnou vlastnost vráceného objektu, pokud se názvy vlastností shodují, nebo se přidají do slovníku JsonExtensionDataAttribute přetečení, pokud existuje; jinak se ignorují.

Umožňuje Preserve povolit zachování jedinečných odkazů na objekty při serializaci a spotřebě metadat ke čtení zachování odkazů na deserializaci.