DeadlockDetectionPolicy Class |
System.Attribute
PostSharp.Extensibility.MulticastAttribute
PostSharp.Aspects.Aspect
PostSharp.Aspects.AssemblyLevelAspect
PostSharp.Patterns.Threading.DeadlockDetectionPolicy
Namespace: PostSharp.Patterns.Threading
Assembly: PostSharp.Patterns.Threading (in PostSharp.Patterns.Threading.dll) Version: 6.5.19.0 (6.5.19.0)
public sealed class DeadlockDetectionPolicy : AssemblyLevelAspect, IAspectProvider, IAspect, IService
The DeadlockDetectionPolicy type exposes the following members.
| Name | Description | |
|---|---|---|
| DeadlockDetectionPolicy | Initializes a new instance of the DeadlockDetectionPolicy 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.) | |
| 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 AssemblyLevelAspect.) | |
| CompileTimeValidate(Object) |
Method invoked at build time to ensure that the aspect has been applied to the right target.
(Inherited from AssemblyLevelAspect.) | |
| CompileTimeValidate(Assembly) |
Method invoked at build time to ensure that the aspect has been applied to the right target.
(Overrides AssemblyLevelAspect.CompileTimeValidate(Assembly).) | |
| GetAspectConfiguration |
Method invoked at build tome to get the imperative configuration of the current Aspect.
(Inherited from Aspect.) | |
| IsEnabled |
Determines whether an Assembly has been instrumented for deadlock detection.
|
The DeadlockDetectionPolicy works by building, in real time, a graph of dependencies between threads and waiting objects. All synchronization aspects of the threading pattern library, additionally to the most common .NET synchronization primitives. The following .NET methods that are supported: Mutex.WaitOne, Mutex.WaitAll, Mutex.Release, Mutex.SignalAndWait, Monitor.Enter, Monitor.Exit, Monitor.TryEnter, Thread.Join, all methods of ReaderWriterLockSlim, all methods of ReaderWriterLock except ReaderWriterLock.ReleaseLock, ReaderWriterLock.RestoreLock, all methods of Dispatcher, Dispatcher.BeginInvoke, Dispatcher.InvokeAsync, DispatcherOperation.Wait, Dispatcher
When synchronization objects wait for more then 200ms, a deadlock detection is performed. The algorithm analyzes the dependency graph for cycles and throws a DeadlockException in all threads involved in the cycle if one is detected.
Some actions on synchronization primitives, such as ReaderWriterLock.RestoreLock and WaitHandle.Handle, make it impossible to track deadlocks. If such methods are called, the synchronization primitive is excluded from the deadlock detection mechanism. If too many objects are excluded, the deadlock detection is automatically turned off.