TaskContinuationOptions 枚举

定义

命名空间:

System.Threading.Tasks

程序集:

System.Threading.Tasks.dll

程序集:

System.Runtime.dll

程序集:

mscorlib.dll

程序集:

netstandard.dll

为通过使用 ContinueWith(Action<Task>, CancellationToken, TaskContinuationOptions, TaskScheduler) 或 ContinueWith(Action<Task<TResult>>, TaskContinuationOptions) 方法创建的任务指定行为。

此枚举支持其成员值的按位组合。

public enum class TaskContinuationOptions

[System.Flags]
public enum TaskContinuationOptions

[System.Flags]
[System.Serializable]
public enum TaskContinuationOptions

[<System.Flags>]
type TaskContinuationOptions = 

[<System.Flags>]
[<System.Serializable>]
type TaskContinuationOptions = 

Public Enum TaskContinuationOptions

继承

Object

ValueType

Enum

TaskContinuationOptions

属性

FlagsAttribute SerializableAttribute

字段

AttachedToParent	4	如果延续为子任务，则指定将延续附加到任务层次结构中的父级。 只有当延续前面的任务也是子任务时，延续才可以是子任务。 默认情况下，子任务（即由外部任务创建的内部任务）将独立于其父任务执行。 可以使用 AttachedToParent 选项以便将父任务和子任务同步。 请注意，如果使用 DenyChildAttach 选项配置父任务，则子任务中的 AttachedToParent 选项不起作用，并且子任务将作为分离的子任务执行。 有关详细信息，请参阅附加和分离的子任务。
DenyChildAttach	8	指定任何使用 AttachedToParent 选项创建，并尝试作为附加的子任务执行的子任务（即，由此延续创建的任何嵌套内部任务）都无法附加到父任务，会改成作为分离的子任务执行。 有关详细信息，请参阅附加和分离的子任务。
ExecuteSynchronously	524288	指定应同步执行延续任务。 指定此选项后，延续任务在导致前面的任务转换为其最终状态的相同线程上运行。 如果在创建延续任务时已经完成前面的任务，则延续任务将在创建此延续任务的线程上运行。 如果前面任务的 CancellationTokenSource 已在一个 finally（在 Visual Basic 中为 Finally）块中释放，则使用此选项的延续任务将在该 finally 块中运行。 只应同步执行运行时间非常短的延续任务。 由于任务以同步方式执行，因此无需调用诸如 Wait() 的方法来确保调用线程等待任务完成。
HideScheduler	16	指定由延续通过调用方法（如 Run(Action) 或 ContinueWith(Action<Task>)）创建的任务将默认计划程序 (Default) 视为当前的计划程序，而不是正在运行该延续的计划程序。
LazyCancellation	32	在延续取消的情况下，防止延续的完成直到完成先前的任务。
LongRunning	2	指定延续将是长期运行的、粗粒度的操作。 它会向 TaskScheduler 提示，过度订阅可能是合理的。
None	0	如果未指定延续选项，应在执行延续任务时使用指定的默认行为。 延续任务在前面的任务完成后以异步方式运行，与前面任务最终的 Status 属性值无关。 如果延续是子任务，则会将其创建为分离的嵌套任务。
NotOnCanceled	262144	指定不应在延续任务前面的任务已取消的情况下安排延续任务。 如果前面任务完成的 Status 属性是 Canceled，则前面的任务会取消。 此选项对多任务延续无效。
NotOnFaulted	131072	指定不应在延续任务前面的任务引发了未处理异常的情况下安排延续任务。 如果前面任务完成的 Status 属性是 Faulted，则前面的任务会引发未处理的异常。 此选项对多任务延续无效。
NotOnRanToCompletion	65536	指定不应在延续任务前面的任务已完成运行的情况下安排延续任务。 如果前面任务完成的 Status 属性是 RanToCompletion，则前面的任务会运行直至完成。 此选项对多任务延续无效。
OnlyOnCanceled	196608	指定只应在延续前面的任务已取消的情况下安排延续任务。 如果前面任务完成的 Status 属性是 Canceled，则前面的任务会取消。 此选项对多任务延续无效。
OnlyOnFaulted	327680	指定只有在延续任务前面的任务引发了未处理异常的情况下才应安排延续任务。 如果前面任务完成的 Status 属性是 Faulted，则前面的任务会引发未处理的异常。 OnlyOnFaulted 选项可保证前面任务中的 Exception 属性不是 null。 你可以使用该属性来捕获异常，并确定导致任务出错的异常。 如果你不访问 Exception 属性，则不会处理异常。 此外，如果尝试访问已取消或出错的任务的 Result 属性，则会引发一个新异常。 此选项对多任务延续无效。
OnlyOnRanToCompletion	393216	指定只应在延续任务前面的任务已完成运行的情况下才安排延续任务。 如果前面任务完成的 Status 属性是 RanToCompletion，则前面的任务会运行直至完成。 此选项对多任务延续无效。
PreferFairness	1	提示 TaskScheduler 按任务计划的顺序安排任务，因此较早安排的任务将更可能较早运行，而较晚安排运行的任务将更可能较晚运行。
RunContinuationsAsynchronously	64	指定应异步运行延续任务。 此选项优先于 ExecuteSynchronously。