Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

TaskContinuationOptions Enumeration

Specifies the behavior for a task that is created by using the Task.ContinueWith or Task<TResult>.ContinueWith method.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

Namespace:  System.Threading.Tasks
Assembly:  mscorlib (in mscorlib.dll)
[SerializableAttribute]
[FlagsAttribute]
public enum TaskContinuationOptions
Member nameDescription
NoneDefault = "Continue on any, no task options, run asynchronously" Specifies that the default behavior should be used. Continuations, by default, will be scheduled when the antecedent task completes, regardless of the task's final TaskStatus.
PreferFairnessA hint to a TaskScheduler to schedule a task in as fair a manner as possible, meaning that tasks scheduled sooner will be more likely to be run sooner, and tasks scheduled later will be more likely to be run later.
LongRunningSpecifies that a task will be a long-running, course-grained operation. It provides a hint to the TaskScheduler that oversubscription may be warranted.
AttachedToParentSpecifies that a task is attached to a parent in the task hierarchy.
NotOnRanToCompletionSpecifies that the continuation task should not be scheduled if its antecedent ran to completion. This option is not valid for multi-task continuations.
NotOnFaultedSpecifies that the continuation task should not be scheduled if its antecedent threw an unhandled exception. This option is not valid for multi-task continuations.
NotOnCanceledSpecifies that the continuation task should not be scheduled if its antecedent was canceled. This option is not valid for multi-task continuations.
OnlyOnRanToCompletionSpecifies that the continuation task should be scheduled only if its antecedent ran to completion. This option is not valid for multi-task continuations.
OnlyOnFaultedSpecifies that the continuation task should be scheduled only if its antecedent threw an unhandled exception. This option is not valid for multi-task continuations.
OnlyOnCanceledSpecifies that the continuation task should be scheduled only if its antecedent was canceled. This option is not valid for multi-task continuations.
ExecuteSynchronouslySpecifies that the continuation task should be executed synchronously. With this option specified, the continuation will be run on the same thread that causes the antecedent task to transition into its final state. If the antecedent is already complete when the continuation is created, the continuation will run on the thread creating the continuation. Only very short-running continuations should be executed synchronously.

.NET Framework

Supported in: 4

.NET Framework Client Profile

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.