PostSharp 2023.0 / / Post­Sharp Documentation / API Reference / Post­Sharp.​Patterns.​Threading Namespace / Background­Attribute Class / Background­Attribute Methods / Background­Attribute.​On­Invoke­Async Method

BackgroundAttribute.OnInvokeAsync Method

Method invoked instead of the method to which the aspect has been applied.

Namespace:  PostSharp.Patterns.Threading
Assembly:  PostSharp.Patterns.Threading (in PostSharp.Patterns.Threading.dll) Version: 2023.0.3.0 (2023.0.3.0)
Syntax
C#
Copy
public override Task OnInvokeAsync(
	MethodInterceptionArgs args
)

Parameters

args
Type: PostSharp.Aspects.MethodInterceptionArgs
Advice arguments.

Return Value

Type: Task

Implements

IAsyncMethodInterceptionAspect.OnInvokeAsync(MethodInterceptionArgs)
Remarks

The implementation of OnInvokeAsync(MethodInterceptionArgs) may invoke ProceedAsync(), may schedule it for invocation from another thread, or may completely skip its invocation. Alternatively, it may use Binding. Before returning to the caller, the OnInvokeAsync(MethodInterceptionArgs) method must set the return value (property ReturnValue), otherwise the target method may fail with a NullReferenceException. It is normally set by calling ProceedAsync().

If semantic advising applies to a method and the method is an async method or returns a Task, then OnInvokeAsync(MethodInterceptionArgs) is called for that method instead of OnInvoke(MethodInterceptionArgs).

See Also