JsonSerializerOptions.ReferenceHandler Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia obiekt określający sposób obsługi odwołań do obiektów podczas odczytywania i zapisywania kodu 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
Wartość właściwości
Uwagi
Domyślnie serializacja nie obsługuje obiektów z cyklami i nie zachowuje zduplikowanych odwołań. Właściwości metadanych nie będą zapisywane podczas serializacji typów odwołań i będą traktowane jako zwykłe właściwości deserializacji.
Na serializacji:
- Traktuje zduplikowane odwołania do obiektów tak, jakby były unikatowe i zapisuje wszystkie ich właściwości.
- Serializator zgłasza wyjątek JsonException , jeśli obiekt zawiera cykl.
Podczas deserializacji:
- Właściwości metadanych (
$id
,$values
, i$ref
) nie będą używane i dlatego będą traktowane jako zwykłe właściwości JSON. - Właściwości metadanych mogą być mapowane na właściwość rzeczywistą zwróconego obiektu, jeśli nazwy właściwości są zgodne lub zostaną dodane do JsonExtensionDataAttribute słownika przepełnienia, jeśli istnieje; w przeciwnym razie są one ignorowane.
- Właściwości metadanych (
Służy Preserve do włączania zachowywania unikatowych odwołań do obiektów w przypadku serializacji i zużycia metadanych w celu odczytywania zachowanych odwołań do deserializacji.