JsonObjectCreationHandlingAttribute クラス

定義

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

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

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

Public NotInheritable Class JsonObjectCreationHandlingAttribute
Inherits JsonAttribute

継承

Object

Attribute

JsonAttribute

JsonObjectCreationHandlingAttribute

属性

AttributeUsageAttribute

注釈

フィールドまたはプロパティに配置すると、この属性はメンバーが置き換えられるか設定されるかを示します。 既定のリゾルバーを使用すると、この属性は ObjectCreationHandlingにマップされます。

Populateを持つ型に配置すると、この属性は、作成をサポートするすべてのメンバーが設定されることを示します。 既定のリゾルバーを使用すると、この属性は PreferredPropertyObjectCreationHandlingにマップされます。

この属性は、型に配置された場合のプロパティの作成処理の推奨値にのみ対応します。 たとえば、Populateを持つJsonObjectCreationHandlingAttributeがクラスに配置され、プロパティを設定できない場合は、置き換えられます。 たとえば、値型にセッターがない場合や、プロパティがIEnumerable<T>型の場合は、true可能性があります。

プロパティ型のみが考慮されます。 たとえば、プロパティが IEnumerable<T> 型であり、 List<T>型の実行時値を持つ場合、 IEnumerable<T> は設定できないため、値が設定されません。

値型では、作成をサポートするためにセッターが必要です。 このような場合、逆シリアル化ではプロパティ値のコピーが使用され、完了するとセッターに割り当てられます。