Partager via

VsTaskContinuationOptions Enum

  • Reference

Definition

Namespace:
Microsoft.VisualStudio.Shell
Assembly:
Microsoft.VisualStudio.Shell.14.0.dll
Assembly:
Microsoft.VisualStudio.Shell.15.0.dll
Assembly:
Microsoft.VisualStudio.Shell.Framework.dll
Package:
Microsoft.VisualStudio.Shell.Framework v17.11.40262

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
Enum
VsTaskContinuationOptions
Attributes
FlagsAttribute

Fields

Name Value Description
NotCancelable -2147483648

Marks the task as not cancelable. Users will get exception if they try to cancel the task.
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.
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.
LongRunning 2

For background tasks, this will cause the task to run its own thread instead of thread pool.
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.
DenyChildAttach 8

An InvalidOperationException is thrown if an attempt is made to attach a child task to the created task.
LazyCancelation 32

In the case of continuation cancellation, prevents completion of the continuation until the antecedent has completed.
NotOnRanToCompletion 65536

The continuation task should not be scheduled if its antecedent ran to completion. This option is not valid for multi-task continuations.
Default 131072

The same as NotOnFaulted.
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.
OnlyOnCanceled 196608
NotOnCanceled 262144

The continuation task should not be scheduled if its antecedent was canceled. This option is not valid for multi-task continuations.
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.
ExecuteSynchronously 524288

This option is not supported by the VS task library and it will be ignored hence continuations will not be inlined.
CancelWithParent 536870912

Cancels the task when its parent is canceled.
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.

Applies to