ObjectCreationHandlingAttribute Class

Definition

Namespace

Bodu.Text.Serialization

Assembly

Bodu.Text.Serialization.dll

Package

Bodu.Text.Serialization 1.0.0

Source

ObjectCreationHandlingAttribute.cs

Specifies, for the annotated type or member, whether the serializer replaces the value with a freshly created instance or populates the value already held during deserialization, overriding the serializer-wide preferred object-creation handling.

[AttributeUsage(AttributeTargets.Class|AttributeTargets.Struct|AttributeTargets.Property|AttributeTargets.Field|AttributeTargets.Interface, AllowMultiple = false)]
public sealed class ObjectCreationHandlingAttribute : SerializationAttribute

Inheritance

object

Attribute

SerializationAttribute

ObjectCreationHandlingAttribute

Attributes

System.AttributeUsageAttribute

Inherited Members

Attribute.Equals(object)

Attribute.GetCustomAttribute(Assembly, Type)

Attribute.GetCustomAttribute(Assembly, Type, bool)

Attribute.GetCustomAttribute(MemberInfo, Type)

Attribute.GetCustomAttribute(MemberInfo, Type, bool)

Attribute.GetCustomAttribute(Module, Type)

Attribute.GetCustomAttribute(Module, Type, bool)

Attribute.GetCustomAttribute(ParameterInfo, Type)

Attribute.GetCustomAttribute(ParameterInfo, Type, bool)

Attribute.GetCustomAttributes(Assembly)

Attribute.GetCustomAttributes(Assembly, bool)

Attribute.GetCustomAttributes(Assembly, Type)

Attribute.GetCustomAttributes(Assembly, Type, bool)

Attribute.GetCustomAttributes(MemberInfo)

Attribute.GetCustomAttributes(MemberInfo, bool)

Attribute.GetCustomAttributes(MemberInfo, Type)

Attribute.GetCustomAttributes(MemberInfo, Type, bool)

Attribute.GetCustomAttributes(Module)

Attribute.GetCustomAttributes(Module, bool)

Attribute.GetCustomAttributes(Module, Type)

Attribute.GetCustomAttributes(Module, Type, bool)

Attribute.GetCustomAttributes(ParameterInfo)

Attribute.GetCustomAttributes(ParameterInfo, bool)

Attribute.GetCustomAttributes(ParameterInfo, Type)

Attribute.GetCustomAttributes(ParameterInfo, Type, bool)

Attribute.GetHashCode()

Attribute.IsDefaultAttribute()

Attribute.IsDefined(Assembly, Type)

Attribute.IsDefined(Assembly, Type, bool)

Attribute.IsDefined(MemberInfo, Type)

Attribute.IsDefined(MemberInfo, Type, bool)

Attribute.IsDefined(Module, Type)

Attribute.IsDefined(Module, Type, bool)

Attribute.IsDefined(ParameterInfo, Type)

Attribute.IsDefined(ParameterInfo, Type, bool)

Attribute.Match(object)

Attribute.TypeId

object.Equals(object, object)

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Extension Methods

ComparableExtensions.AtLeast<T>(T, T, IComparer<T>)

ComparableExtensions.AtMost<T>(T, T, IComparer<T>)

ComparableExtensions.IsEqualTo<T>(T, T, IComparer<T>)

ComparableExtensions.Max<T>(T, T, IComparer<T>)

ComparableExtensions.Min<T>(T, T, IComparer<T>)

Examples

public sealed class Pipeline
{
    [ObjectCreationHandling(ObjectCreationHandling.Populate)]
    public List<string> Steps { get; } = new() { "restore" };
}

// Deserialized entries are appended to the existing list instead of replacing it.

Remarks

When applied to a member the attribute governs that member alone; when applied to a type it governs every member of the type that does not carry its own attribute. A member-level attribute takes precedence over a type-level one, and both take precedence over the options-level default.

Constructors

ObjectCreationHandlingAttribute(ObjectCreationHandling)

Initializes a new instance of the ObjectCreationHandlingAttribute class.

public ObjectCreationHandlingAttribute(ObjectCreationHandling handling)

Parameters

handling ObjectCreationHandling

The object-creation handling applied to the annotated type or member.

Exceptions

ArgumentOutOfRangeException

Thrown when handling is not a defined ObjectCreationHandling value.

Properties

Handling

Gets the object-creation handling applied to the annotated type or member.

public ObjectCreationHandling Handling { get; }

Property Value

ObjectCreationHandling

The object-creation handling.

Applies to

Product	Versions
.NET	8, 10