PostSharp 2023.0 / / Post­Sharp Documentation / API Reference / Post­Sharp.​Aspects.​Advices Namespace / On­Method­Yield­Advice Class

OnMethodYieldAdvice Class
Custom attribute that, when applied on a method of an aspect class, specifies that this method is an advice having the same semantics as OnYield(MethodExecutionArgs).
Inheritance Hierarchy
System.Object
  System.Attribute
    PostSharp.Aspects.Advices.Advice
      PostSharp.Aspects.Advices.GroupingAdvice
        PostSharp.Aspects.Advices.OnMethodBoundaryAdvice
          PostSharp.Aspects.Advices.OnMethodYieldAdvice

Namespace:  PostSharp.Aspects.Advices
Assembly:  PostSharp (in PostSharp.dll) Version: 2023.0.3.0 (2023.0.3.0)
Syntax
C#
Copy
public sealed class OnMethodYieldAdvice : OnMethodBoundaryAdvice

The OnMethodYieldAdvice type exposes the following members.

Constructors
  NameDescription
Public methodOnMethodYieldAdvice
Initializes a new instance of the OnMethodYieldAdvice class
Properties
  NameDescription
Public propertyDescription
A human-readable description of the current advice.
(Inherited from Advice.)
Public propertyLinesOfCodeAvoided
Reduction in the code lines count achieved by applying the advice instance to one code element.
(Inherited from Advice.)
Public propertyMaster
Name of the master advice method. If this property is not set, the current method is itself the master of the group. Only master methods can define selectors (Pointcut) and dependencies (AspectDependencyAttribute).
(Inherited from GroupingAdvice.)
Public propertySemanticallyAdvisedMethodKinds
Determines which target methods will be advised semantically. This affects the behavior of the advice when it's applied to iterator or async methods, which are compiled into state machines.
(Inherited from OnMethodBoundaryAdvice.)
Public propertyUnsupportedTargetAction
Specifies the action to take when the advice is applied to an unsupported target method.
(Inherited from OnMethodBoundaryAdvice.)
Remarks

The method to which this custom attribute is applied must be public and must have the same signature as OnYield(MethodExecutionArgs). However, it can be static.


If an aspect defines many advices (among OnMethodEntryAdvice , OnMethodExitAdvice , OnMethodSuccessAdvice and OnMethodExceptionAdvice ) that are meant to be applied to the same methods with consistent ordering, these advices should be grouped together (see Master property).

Note Note
Standalone advices or group masters should also be annotated by a custom attribute derived from Pointcut .
See Also