JsonSerializerOptions.ReferenceHandler Własność
Definicja
Ważny
Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.
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ść nieruchomoś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.