Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

CallbackBehaviorAttribute::ConcurrencyMode Property

 

Gets or sets whether a service supports one thread, multiple threads, or reentrant calls.

Namespace:   System.ServiceModel
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

public:
property ConcurrencyMode ConcurrencyMode {
	ConcurrencyMode get();
	void set(ConcurrencyMode value);
}

Property Value

Type: System.ServiceModel::ConcurrencyMode

One of the ConcurrencyMode values; the default is Single.

Exception Condition
ArgumentOutOfRangeException

The value is not one of the ConcurrencyMode values.

This property indicates whether an instance of a callback object supports one thread or multiple threads that execute concurrently, and if single-threaded, whether reentrancy is supported.

Setting ConcurrencyMode to Single instructs the system to restrict instances of the service to one thread of execution at a time, which frees you from dealing with threading issues. This is the default value. A value of Multiple means that service objects can be executed by multiple threads at any one time. In this case, you must ensure thread safety and state consistency.

Reentrantalso restricts access to a single thread at a time. However, it enables calls out from an executing service method to return and reenter the executing service. A reentrant call can execute on a different managed thread, but in this case the original thread is blocked for the duration of the reentrant call.

Generally, if a message arrives for an instance that violates its concurrency mode, the message waits until the instance is available, or until it times out.

In addition, if the ConcurrencyMode is set to Single and a reentrant call is blocked while waiting for the instance to be freed, the system detects the deadlock and throws an exception.

For more information about concurrency, see ServiceBehaviorAttribute::ConcurrencyMode and Sessions, Instancing, and Concurrency.

.NET Framework
Available since 3.0
Return to top
Show:
© 2017 Microsoft