VsTaskContinuationOptions Enum
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Managed definition of __VSTASKCONTINUATIONOPTIONS/__VSTASKCONTINUATIONOPTIONS2.
This enumeration supports a bitwise combination of its member values.
public enum class VsTaskContinuationOptions
public enum class VsTaskContinuationOptions
enum VsTaskContinuationOptions
[System.Flags]
public enum VsTaskContinuationOptions
[<System.Flags>]
type VsTaskContinuationOptions =
Public Enum VsTaskContinuationOptions
- Inheritance
-
VsTaskContinuationOptions
- Attributes
Fields
AttachedToParent | 4 | Creates the task as attached to the currently running task. The parent task will not be marked as completed until this task is completed as well. |
CancelWithParent | 536870912 | Cancels the task when its parent is canceled. |
Default | 131072 | The same as NotOnFaulted. |
DenyChildAttach | 8 | An InvalidOperationException is thrown if an attempt is made to attach a child task to the created task. |
ExecuteSynchronously | 524288 | This option is not supported by the VS task library and it will be ignored hence continuations will not be inlined. |
IndependentlyCanceled | 1073741824 | Separates the continuation task's cancelation so that it can be canceled independently. So canceling the current task doesn't cancel the continuation task and it executes in the order it is scheduled. |
LazyCancelation | 32 | In the case of continuation cancellation, prevents completion of the continuation until the antecedent has completed. |
LongRunning | 2 | For background tasks, this will cause the task to run its own thread instead of thread pool. |
None | 0 | Default = "Continue on any, no task options, run asynchronously" Specifies that the default behavior should be used. Continuations, by default, are scheduled when the antecedent task completes, regardless of the task's final state. |
NotCancelable | -2147483648 | Marks the task as not cancelable. Users will get exception if they try to cancel the task. |
NotOnCanceled | 262144 | The continuation task should not be scheduled if its antecedent was canceled. This option is not valid for multi-task continuations. |
NotOnFaulted | 131072 | The continuation task should not be scheduled if its antecedent threw an unhandled exception. This option is not valid for multi-task continuations. |
NotOnRanToCompletion | 65536 | The continuation task should not be scheduled if its antecedent ran to completion. This option is not valid for multi-task continuations. |
OnlyOnCanceled | 196608 | |
OnlyOnFaulted | 327680 | The continuation task should be scheduled only if its antecedent threw an unhandled exception. This option is not valid for multi-task continuations. |
OnlyOnRanToCompletion | 393216 | The continuation task should be scheduled only if its antecedent ran to completion. This option is not valid for multi-task continuations. |
PreferFairness | 1 | A hint to the task library to schedule a task in as fair a manner as possible, meaning that tasks scheduled sooner are more likely to be run sooner, and tasks scheduled later are more likely to be run later. |