Class OverrideMethodAspect

[AttributeUsage(AttributeTargets.Method)]
public abstract class OverrideMethodAspect : MethodAspect, IAspect<IMethod>, IAspect, ICompileTimeSerializable, ITemplateProvider, IEligible<IMethod>

This class simplifies creating aspects that replace method implementations using the decorator pattern. Derived classes must implement the OverrideMethod() template method, which is a T# template that executes at compile-time to generate the new method implementation. Use meta.Proceed() within the template to invoke the original method implementation, and meta.Target.Method to access method metadata.

This aspect automatically selects the appropriate template based on the target method's characteristics:

• OverrideAsyncMethod() for async methods (or all awaitable types if UseAsyncTemplateForAnyAwaitable is true)
• OverrideEnumerableMethod() or OverrideEnumeratorMethod() for iterator methods using yield (or all enumerable types if UseEnumerableTemplateForAnyEnumerable is true)
• OverrideAsyncEnumerableMethod or OverrideAsyncEnumeratorMethod for async iterator methods (or all async enumerable types if both properties are true)
• OverrideMethod() for all other methods

If specialized templates are not overridden, OverrideMethod() is used as the fallback.

Important: When the default OverrideMethod() template is applied to iterator methods, the stream is buffered into a List<T> using Buffer(IEnumerable). For long-running or infinite streams, implement the specific iterator templates (OverrideEnumerableMethod() or OverrideEnumeratorMethod()) to avoid buffering and support streaming.

The properties UseAsyncTemplateForAnyAwaitable and UseEnumerableTemplateForAnyEnumerable control template selection strategy. By default (false), templates are selected based on method modifiers (async, yield). When set to true, selection is based solely on return type, which is useful when you need to handle all methods of certain return types consistently.

For overriding multiple methods from a single aspect or for more control, use Override(IAdviser<IMethod>, in MethodTemplateSelector, object?, object?) from your BuildAspect method instead of deriving from this class.