ThreadPool.SetMaxThreads(Int32, Int32) ThreadPool.SetMaxThreads(Int32, Int32) ThreadPool.SetMaxThreads(Int32, Int32) ThreadPool.SetMaxThreads(Int32, Int32) Method

Definition

Sets the number of requests to the thread pool that can be active concurrently. All requests above that number remain queued until thread pool threads become available.

public:
 static bool SetMaxThreads(int workerThreads, int completionPortThreads);
public static bool SetMaxThreads (int workerThreads, int completionPortThreads);
static member SetMaxThreads : int * int -> bool
Public Shared Function SetMaxThreads (workerThreads As Integer, completionPortThreads As Integer) As Boolean
Parameters
workerThreads
Int32 Int32 Int32 Int32

The maximum number of worker threads in the thread pool.

completionPortThreads
Int32 Int32 Int32 Int32

The maximum number of asynchronous I/O threads in the thread pool.

Returns

true if the change is successful; otherwise, false.

Remarks

You cannot set the maximum number of worker threads or I/O completion threads to a number smaller than the number of processors on the computer. To determine how many processors are present, retrieve the value of the Environment.ProcessorCount property. In addition, you cannot set the maximum number of worker threads or I/O completion threads to a number smaller than the corresponding minimum number of worker threads or I/O completion threads. To determine the minimum thread pool size, call the GetMinThreads method.

If the common language runtime is hosted, for example by Internet Information Services (IIS) or SQL Server, the host can limit or prevent changes to the thread pool size.

Use caution when changing the maximum number of threads in the thread pool. While your code might benefit, the changes might have an adverse effect on code libraries you use.

Setting the thread pool size too large can cause performance problems. If too many threads are executing at the same time, the task switching overhead becomes a significant factor.

Security

SecurityPermission
for the ability to control threads. Permission value: ControlThread

Applies to

See Also