JsonExtensionDataAttribute 類別

定義

命名空間:

System.Text.Json.Serialization

組件:

System.Text.Json.dll

置於 IDictionary<TKey,TValue> 類型的屬性上時，任何沒有相符成員的屬性都會在還原序列化期間新增至該字典，並在序列化期間寫入。

public ref class JsonExtensionDataAttribute sealed : System::Text::Json::Serialization::JsonAttribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)]
public sealed class JsonExtensionDataAttribute : System.Text.Json.Serialization.JsonAttribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)>]
type JsonExtensionDataAttribute = class
    inherit JsonAttribute

Public NotInheritable Class JsonExtensionDataAttribute
Inherits JsonAttribute

繼承

Object

Attribute

JsonAttribute

JsonExtensionDataAttribute

屬性

AttributeUsageAttribute

備註

字典 TKey 的值必須是 String ，而且 TValue 必須是 JsonElement 或 Object 。

在還原序列化期間，使用 Object 時，會將 「null」 JSON 值視為物件參考，而使用 JsonElement 時，會將 「null」 視為 null 設定 JsonValueKind.Null 為 的 JsonElement ValueKind 。

在序列化期間，擴充資料屬性的名稱不會包含在 JSON 中;延伸模組資料中包含的資料會序列化為 JSON 物件的屬性。

如果具有這個延伸模組資料屬性的類型上有多個屬性，或者如果屬性本身不是正確的 IDictionary<TKey,TValue> 類型， InvalidOperationException 則會在該類型的第一次序列化或還原序列化期間擲回 。

如需詳細資訊，請參閱 如何使用 System.Text.Json 處理溢位 JSON。

建構函式

JsonExtensionDataAttribute()

初始化 JsonExtensionDataAttribute 類別的新執行個體。

屬性

TypeId

在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)

方法

Equals(Object)	傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute)
GetHashCode()	傳回這個執行個體的雜湊碼。 (繼承來源 Attribute)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsDefaultAttribute()	在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute)
Match(Object)	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承來源 Attribute)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)