JsonSerializerOptions.ReferenceHandler Właściwość

Definicja

Przestrzeń nazw:

System.Text.Json

Zestaw:

System.Text.Json.dll

Pakiet:

System.Text.Json v9.0.0-preview.3.24172.9

Źródło:

JsonSerializerOptions.cs

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

ReferenceHandler

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.

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.