PostSharp 5.0 / / Post­Sharp Documentation / API Reference / Post­Sharp.​Patterns.​Threading Namespace / Thread­Aware­Extensions Class / Thread­Aware­Extensions Methods / Thread­Aware­Extensions.​Acquire­Access Method / Thread­Aware­Extensions.​Acquire­Access Method (IThread­Aware, Object­Access­Level)

ThreadAwareExtensions.AcquireAccess Method (IThreadAware, ObjectAccessLevel)
Acquires access to given object and returns the ConcurrentAccessToken.

Namespace:  PostSharp.Patterns.Threading
Assembly:  PostSharp.Patterns.Common (in PostSharp.Patterns.Common.dll) Version: 5.0.55.0 (5.0.55.0)
Syntax
C#
Copy
public static ConcurrentAccessToken AcquireAccess(
	this IThreadAware instance,
	ObjectAccessLevel objectAccessLevel
)

Parameters

instance
Type: PostSharp.Patterns.Threading.IThreadAware
The instance for which access is required.
objectAccessLevel
Type: PostSharp.Patterns.Model.ObjectAccessLevel
The level of access required.

Return Value

Type: ConcurrentAccessToken
A ConcurrentAccessToken that should be disposed when access is no longer required.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type IThreadAware. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).
Remarks

This method is guaranteed to acquire the controller of the instance object. Invoking the AcquireAccess(ObjectAccessLevel, ConcurrentAccessToken) method directly does not offer this guarantee, as the controller can be changed between the moment the ConcurrencyController property is retrieved and the moment the AcquireAccess(ObjectAccessLevel, ConcurrentAccessToken) is invoked.

See Also