JsonExtensionDataAttribute 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
置於 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.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
[<System.AttributeUsage(System.AttributeTargets.Property, AllowMultiple=false)>]
type JsonExtensionDataAttribute = class
inherit JsonAttribute
Public NotInheritable Class JsonExtensionDataAttribute
Inherits JsonAttribute
- 繼承
- 屬性
備註
字典 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) |