ThreadPool.SetMaxThreads メソッド

.NET Framework クラス ライブラリ リファレンス

ThreadPool.SetMaxThreads メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

同時にアクティブにできるスレッド プールへの要求の数を設定します。この数を超える要求はすべて、スレッド プール スレッドが使用可能になるまでキューに置かれたままになります。

名前空間: System.Threading
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Function SetMaxThreads
 ( _
    workerThreads As Integer, _
    completionPortThreads As Integer _
) As Boolean

Visual Basic (使用法)

Dim workerThreads As Integer
Dim completionPortThreads As Integer
Dim returnValue As Boolean

returnValue = ThreadPool.SetMaxThreads(workerThreads, completionPortThreads)

C#

public static bool SetMaxThreads
 (
    int workerThreads,
    int completionPortThreads
)

C++

public:
static bool SetMaxThreads (
    int workerThreads, 
    int completionPortThreads
)

J#

public static boolean SetMaxThreads (
    int workerThreads, 
    int completionPortThreads
)

JScript

public static function SetMaxThreads
 (
    workerThreads : int, 
    completionPortThreads : int
) : boolean

パラメータ

workerThreads

スレッド プール内のワーカー スレッドの最大数。

completionPortThreads

スレッド プール内の非同期 I/O スレッドの最大数。

戻り値
変更が成功した場合は true。それ以外の場合は false。

解説

ワーカー スレッドの数または I/O 完了スレッドの数に、コンピュータのプロセッサ数より小さい数を設定することはできません。

共通言語ランタイムが IIS や SQL Server などによってホストされている場合、ホストはスレッド プールのサイズの変更を制限または禁止できます。

スレッド プール内のスレッドの最大数を変更するときは、注意が必要です。このような変更はコードの面では利点がありますが、使用するコード ライブラリに悪影響を与える可能性があります。

スレッド プールのサイズが大きすぎると、パフォーマンスに問題が生じることがあります。同時に実行するスレッド数が多すぎる場合、タスク切り替えのオーバーヘッドが重大な要素となります。

Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows CE プラットフォームメモ : 設定できる最大値は 1000 です。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
ThreadPool クラス
ThreadPool メンバ
System.Threading 名前空間
GetMaxThreads
SetMinThreads
GetMinThreads
GetAvailableThreads