JsonSerializerOptions.ReferenceHandler 属性

定义

命名空间:

System.Text.Json

程序集:

System.Text.Json.dll

包:

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

Source:

JsonSerializerOptions.cs

获取或设置一个 对象，该对象指定在读取和写入 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 属性。
  • 如果属性名称匹配，元数据属性可以映射到返回对象上的 real 属性，或者将添加到 JsonExtensionDataAttribute 溢出字典（如果存在），否则忽略它们。

用于 Preserve 在序列化和元数据使用时启用唯一对象引用保留，以便在反序列化时读取保留的引用。