InstanceLevelAspect Class - PostSharp 6.4 Documentation

System.Object
  System.Attribute
    PostSharp.Extensibility.MulticastAttribute
      PostSharp.Aspects.Aspect
        PostSharp.Aspects.TypeLevelAspect
          PostSharp.Aspects.InstanceLevelAspect
            PostSharp.Patterns.Model.AggregatableAttribute
            PostSharp.Patterns.Model.AggregatableClientAttribute
            PostSharp.Patterns.Model.NotifyPropertyChangedAttribute
            PostSharp.Patterns.Recording.EditableObjectAttribute
            PostSharp.Patterns.Recording.RecordableAttribute

C#

Copy

[SerializableAttribute]
public abstract class InstanceLevelAspect : TypeLevelAspect, 
	ICloneAwareAspect, IInstanceScopedAspect, IAspect

	Name	Description
	InstanceLevelAspect	Initializes a new instance of the InstanceLevelAspect class

	Name	Description
	AspectPriority	Gets or sets the weaving priority of the aspect. (Inherited from Aspect.)
	AttributeExclude	If true, indicates that this attribute removes all other instances of the same attribute type from the set of elements defined by the current instance. (Inherited from MulticastAttribute.)
	AttributeInheritance	Determines whether this attribute is inherited (Inherited from MulticastAttribute.)
	AttributePriority	Gets or sets the priority of the current attribute in case that multiple instances are defined on the same element (lower values are processed before). (Inherited from MulticastAttribute.)
	AttributeReplace	Determines whether this attribute replaces other attributes found on the target declarations. (Inherited from MulticastAttribute.)
	AttributeTargetAssemblies	Gets or sets the assemblies to which the current attribute apply. (Inherited from MulticastAttribute.)
	AttributeTargetElements	Gets or sets the kind of elements to which this custom attributes applies. (Inherited from MulticastAttribute.)
	AttributeTargetExternalMemberAttributes	Gets or sets the visibilities, scopes, virtualities, and implementation of members to which this attribute applies, when the member is external to the current module. (Inherited from MulticastAttribute.)
	AttributeTargetExternalTypeAttributes	Gets or sets the visibilities of types to which this attribute applies, when this type is external to the current module. (Inherited from MulticastAttribute.)
	AttributeTargetMemberAttributes	Gets or sets the visibilities, scopes, virtualities, and other characteristics of members to which this attribute applies. (Inherited from MulticastAttribute.)
	AttributeTargetMembers	Gets or sets the expression specifying to which members this instance applies. (Inherited from MulticastAttribute.)
	AttributeTargetParameterAttributes	Gets or sets the passing style (by value, out or ref) of parameters to which this attribute applies. (Inherited from MulticastAttribute.)
	AttributeTargetParameters	Gets or sets the expression specifying to which parameters this instance applies. (Inherited from MulticastAttribute.)
	AttributeTargetTypeAttributes	Gets or sets the attributes of types to which this attribute applies. Visibility, scope (Instance or Static) and generation are the only categories that are taken into account; attributes of other categories are ignored. (Inherited from MulticastAttribute.)
	AttributeTargetTypes	Gets or sets the expression specifying to which types this instance applies. (Inherited from MulticastAttribute.)
	Instance	Gets the object to which the current aspect has been applied.
	SerializerType	Gets or sets the Type of the serializer (a type derived from AspectSerializer) used to serialize the aspect instance at build time and deserialize it at runtime. (Inherited from Aspect.)
	UnsupportedTargetAction	Specifies the action to take when the aspect is applied to an unsupported target element. This property affects only simple aspects, not composite aspects. (Inherited from Aspect.)

	Name	Description
	CompileTimeInitialize	Method invoked at build time to initialize the instance fields of the current aspect. This method is invoked before any other build-time method. (Inherited from TypeLevelAspect.)
	CompileTimeValidate(Object)	Method invoked at build time to ensure that the aspect has been applied to the right target. (Inherited from TypeLevelAspect.)
	CompileTimeValidate(Type)	Method invoked at build time to ensure that the aspect has been applied to the right target. (Inherited from TypeLevelAspect.)
	CreateAspectConfiguration	Method invoked at build time to create a concrete AspectConfiguration instance specifically for the current Aspect type. (Overrides Aspect.CreateAspectConfiguration().)
	CreateInstance	Creates a new instance of the aspect based on the current instance, serving as a prototype.
	GetAspectConfiguration	Method invoked at build tome to get the imperative configuration of the current Aspect. (Inherited from Aspect.)
	OnCloned	Method called after the an object enhanced by the current aspect has been cloned using MemberwiseClone(). The this parameter refers to the new aspect instance in the cloned object.
	RuntimeInitialize	Initializes the current aspect. (Inherited from TypeLevelAspect.)
	RuntimeInitializeInstance	Initializes the aspect instance. This method is invoked when all system elements of the aspect (like member imports) have completed.
	SetAspectConfiguration(AspectConfiguration, Object)	Method invoked at build time to set up an AspectConfiguration object according to the current Aspect instance and a specified target element of the current aspect. (Inherited from TypeLevelAspect.)
	SetAspectConfiguration(AspectConfiguration, Type)	Method invoked at build time to set up an AspectConfiguration object according to the current Aspect instance and a specified target element of the current aspect. (Inherited from TypeLevelAspect.)

This class is provided for convenience. You get the same functionality by deriving your aspect class directly from TypeLevelAspect and implementing the interface IInstanceScopedAspect

See IInstanceScopedAspect for a discussion of instance-scoped aspects.

Note
All classes implementing IAspect should typically be marked as serializable using the SerializableAttribute or PSerializableAttribute custom attribute . Fields that are only used at runtime (and unknown at compile-time) should be carefully marked with the NonSerializedAttribute or PNonSerializedAttribute custom attribute. When PostSharp is used on a platform that does not support aspect serialization (such as .NET Compact Framework, Silverlight, or Windows Phone), or when another aspect serializer is used, it is not necessary to mark the aspect class as serializable. For more information, see Aspect Serialization .

Note

All classes implementing IAspect should typically be marked as serializable using the SerializableAttribute or PSerializableAttribute custom attribute . Fields that are only used at runtime (and unknown at compile-time) should be carefully marked with the NonSerializedAttribute or PNonSerializedAttribute custom attribute. When PostSharp is used on a platform that does not support aspect serialization (such as .NET Compact Framework, Silverlight, or Windows Phone), or when another aspect serializer is used, it is not necessary to mark the aspect class as serializable. For more information, see Aspect Serialization .

Reference

PostSharp.Aspects Namespace

PostSharp.Aspects.IInstanceScopedAspect

Other Resources

Conceptual: Aspect Serialization

Conceptual: Understanding Aspect Lifetime and Scope

Conceptual: Adding Aspects to Derived Classes and Methods Using Attributes

Conceptual: Adding Behaviors to Existing Members

Conceptual: Developing Composite Aspects

Conceptual: Introducing Interfaces, Methods, Properties and Events into Existing Classes

Conceptual: Thread-Unsafe Threading Model