PostSharp 2023.0 / / Post­Sharp Documentation / API Reference / Post­Sharp.​Aspects Namespace / Method­Interception­Aspect Class

MethodInterceptionAspect Class
Aspect that, when applied on a method, intercepts invocations of this method.
Inheritance Hierarchy

Namespace:  PostSharp.Aspects
Assembly:  PostSharp (in PostSharp.dll) Version: 2023.0.3.0 (2023.0.3.0)
Syntax
C#
Copy
[SerializableAttribute]
public abstract class MethodInterceptionAspect : MethodLevelAspect, 
	IMethodInterceptionAspect, IMethodLevelAspect, IAspect, IAsyncMethodInterceptionAspect

The MethodInterceptionAspect type exposes the following members.

Constructors
  NameDescription
Protected methodMethodInterceptionAspect
Initializes a new instance of the MethodInterceptionAspect class
Properties
  NameDescription
Public propertyAspectPriority
Gets or sets the weaving priority of the aspect.
(Inherited from Aspect.)
Public propertyAttributeExclude
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.)
Public propertyAttributeInheritance
Determines whether this attribute is inherited
(Inherited from MulticastAttribute.)
Public propertyAttributePriority
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.)
Public propertyAttributeReplace
Determines whether this attribute replaces other attributes found on the target declarations.
(Inherited from MulticastAttribute.)
Public propertyAttributeTargetAssemblies
Gets or sets the assemblies to which the current attribute apply.
(Inherited from MulticastAttribute.)
Public propertyAttributeTargetElements
Gets or sets the kind of elements to which this custom attributes applies.
(Inherited from MulticastAttribute.)
Public propertyAttributeTargetExternalMemberAttributes
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.)
Public propertyAttributeTargetExternalTypeAttributes
Gets or sets the visibilities of types to which this attribute applies, when this type is external to the current module.
(Inherited from MulticastAttribute.)
Public propertyAttributeTargetMemberAttributes
Gets or sets the visibilities, scopes, virtualities, and other characteristics of members to which this attribute applies.
(Inherited from MulticastAttribute.)
Public propertyAttributeTargetMembers
Gets or sets the expression specifying to which members this instance applies.
(Inherited from MulticastAttribute.)
Public propertyAttributeTargetParameterAttributes
Gets or sets the passing style (by value, out or ref) of parameters to which this attribute applies.
(Inherited from MulticastAttribute.)
Public propertyAttributeTargetParameters
Gets or sets the expression specifying to which parameters this instance applies.
(Inherited from MulticastAttribute.)
Public propertyAttributeTargetTypeAttributes
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.)
Public propertyAttributeTargetTypes
Gets or sets the expression specifying to which types this instance applies.
(Inherited from MulticastAttribute.)
Protected propertySemanticallyAdvisedMethodKinds
Determines which target methods will be advised semantically. This affects the behavior of the aspect when it's applied to iterator or async methods, which are compiled into state machines.
Protected propertySerializerType
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.)
Public propertyUnsupportedTargetAction
Specifies the action to take when the aspect is applied to an async method with unsupported return value type.
Methods
  NameDescription
Public methodCompileTimeInitialize
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 MethodLevelAspect.)
Public methodCompileTimeValidate(Object)
Method invoked at build time to ensure that the aspect has been applied to the right target.
(Inherited from MethodLevelAspect.)
Public methodCompileTimeValidate(MethodBase)
Method invoked at build time to ensure that the aspect has been applied to the right target.
(Inherited from MethodLevelAspect.)
Protected methodCreateAspectConfiguration
Method invoked at build time to create a concrete AspectConfiguration instance specifically for the current Aspect type.
(Overrides Aspect.CreateAspectConfiguration().)
Public methodGetAspectConfiguration
Method invoked at build tome to get the imperative configuration of the current Aspect.
(Inherited from Aspect.)
Public methodOnInvoke
Method invoked instead of the method to which the aspect has been applied.
Public methodOnInvokeAsync
Method invoked instead of the method to which the aspect has been applied.
Public methodRuntimeInitialize
Initializes the current aspect.
(Inherited from MethodLevelAspect.)
Protected methodSetAspectConfiguration(AspectConfiguration, MethodBase)
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.
(Overrides MethodLevelAspect.SetAspectConfiguration(AspectConfiguration, MethodBase).)
Protected methodSetAspectConfiguration(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 MethodLevelAspect.)
Remarks

Applying a MethodInterceptionAspect to a method results in the body of this method to be replaced by a call to the aspect OnInvoke(MethodInterceptionArgs) method of the current class. The original method body is moved into a new method, which can be called by the aspect by invoking the Proceed() method, or by using the object Binding.

Note Note
PostSharp creates a local copy of all by-reference parameters (in, out, ref) and this local copy is passed to the intercepted method, not the original argument. This may have unwanted effects on multi-threaded code (because the argument value is not changed at the same moment as before) or when applying the aspect on a P-Invoke method (because a by-reference parameter could represent the starting address of a larger buffer).

Note 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 .
See Also