TaskCreationOptions 列挙型
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
タスクの作成と実行のオプションの動作を制御するフラグを指定します。
この列挙体は、メンバー値のビットごとの組み合わせをサポートしています。
public enum class TaskCreationOptions[System.Flags]
public enum TaskCreationOptions[System.Flags]
[System.Serializable]
public enum TaskCreationOptions[<System.Flags>]
type TaskCreationOptions = [<System.Flags>]
[<System.Serializable>]
type TaskCreationOptions = Public Enum TaskCreationOptions- 継承
- 属性
フィールド
| 名前 | 値 | 説明 |
|---|---|---|
| None | 0 | 既定の動作を使用することを指定します。 |
| PreferFairness | 1 | できるだけ公平な方法でタスクをスケジュールするための TaskScheduler のヒント。つまり、スケジュールされたタスクは早く実行される可能性が高くなり、後でスケジュールされたタスクは後で実行される可能性が高くなります。 |
| LongRunning | 2 | タスクが、粒度の細かいシステムよりも少ない大きなコンポーネントを含む、実行時間の長い粗い操作であることを指定します。 オーバーサブスクリプションが保証される可能性があることを TaskScheduler に示します。 オーバーサブスクリプションを使用すると、使用可能な数のハードウェア スレッドよりも多くのスレッドを作成できます。 また、タスク スケジューラに対して、ローカル スレッド プール キュー上の他のスレッドまたは作業項目の進行をブロックしないように、タスクに追加のスレッドが必要になる可能性があることを示すヒントも提供します。 |
| AttachedToParent | 4 | タスクがタスク階層内の親にアタッチされることを指定します。 既定では、子タスク (つまり、外部タスクによって作成された内部タスク) は、親とは別に実行されます。 AttachedToParent オプションを使用して、親タスクと子タスクを同期させることができます。 親タスクが DenyChildAttach オプションで構成されている場合、子タスクの AttachedToParent オプションは無効になり、子タスクはデタッチされた子タスクとして実行されることに注意してください。 詳細については、「アタッチされた子タスクとデタッチされた子タスク」を参照してください。 |
| DenyChildAttach | 8 | アタッチされた子タスクとして実行しようとする子タスク (つまり、 AttachedToParent オプションを使用して作成) が親タスクにアタッチできず、デタッチされた子タスクとして実行されることを指定します。 詳細については、「アタッチされた子タスクとデタッチされた子タスク」を参照してください。 |
| HideScheduler | 16 | アンビエント スケジューラが、作成されたタスクの現在のスケジューラと見なされないようにします。 つまり、作成されたタスクで実行される StartNew や ContinueWith などの操作には、現在のスケジューラとして Default が表示されます。 |
| RunContinuationsAsynchronously | 64 | 現在のタスクに追加された継続を強制的に非同期的に実行します。 RunContinuationsAsynchronously メンバーは、.NET Framework 4.6 以降の TaskCreationOptions 列挙型で使用できます。 |
注釈
TaskCreationOptions列挙は、次のメソッドで使用されます。
creationOptionsパラメーターを持つTaskFactoryコンストラクターとTaskFactory<TResult> コンストラクター。タスク ファクトリによって作成されるタスクの既定のオプションを指定します。タスクの動作をカスタマイズするために使用するオプションを指定する、
creationOptionsパラメーターを持つTaskコンストラクターとTask<TResult> コンストラクター。creationOptionsパラメーターを持つStartNewメソッドとStartNew メソッド。タスクの動作をカスタマイズするために使用するオプションを指定します。creationOptionsパラメーターを持つFromAsyncメソッドとFromAsync メソッド。指定したIAsyncResultが完了したときに終了メソッドを実行するタスクの動作をカスタマイズするために使用するオプションを指定します。基になるタスクの動作をカスタマイズするために使用するオプションを指定する、
creationOptionsパラメーターを持つTaskCompletionSource<TResult>コンストラクター。