JsonSerializerOptions.ReferenceHandler 屬性

定義

命名空間:

System.Text.Json

組件:

System.Text.Json.dll

套件:

System.Text.Json v9.0.0-rc.2.24473.5

來源:

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 屬性。
  • 如果屬性名稱相符，中繼資料屬性可以對應至所傳回物件的實數屬性，如果存在，則會加入溢 JsonExtensionDataAttribute 位字典;否則會忽略它們。

用來 Preserve 在序列化和中繼資料耗用量上啟用唯一的物件參考保留，以讀取還原序列化上的保留參考。