JsonSerializerOptions.ReferenceHandler 属性

定义

命名空间:

System.Text.Json

程序集:

System.Text.Json.dll

获取或设置一个对象，该对象指定在读取和写入 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

属性值

ReferenceHandler

注解

默认情况下，序列化不支持具有周期的对象，并且不保留重复引用。 序列化引用类型时不会编写元数据属性，并且将被视为反序列化上的常规属性。

• 在序列化时：

  • 将重复的对象引用视为唯一，并写入其所有属性。
  • 序列化程序会引发一个 JsonException 如果对象包含一个循环。

• 在反序列化上：

  • 不会使用元数据属性 ($id``$values和$ref) ，因此将被视为常规 JSON 属性。
  • 如果属性名称匹配，则元数据属性可以映射到返回对象的实体属性，或者将添加到 JsonExtensionDataAttribute 溢出字典（如果存在）;否则将忽略它们。

用于 Preserve 在序列化和元数据消耗上启用唯一对象引用保留以读取反序列化上的保留引用。