Udostępnij za pośrednictwem


TaskContinuationOptions Wyliczenie

Definicja

Określa zachowanie zadania utworzonego przy użyciu ContinueWith(Action<Task>, CancellationToken, TaskContinuationOptions, TaskScheduler) metody or ContinueWith(Action<Task<TResult>>, TaskContinuationOptions) .

To wyliczenie obsługuje bitową kombinację jego wartości składowych.

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
Dziedziczenie
TaskContinuationOptions
Atrybuty

Pola

AttachedToParent 4

Określa, że kontynuacja, jeśli jest podrzędnym zadaniem, jest dołączona do elementu nadrzędnego w hierarchii zadań. Kontynuacja może być zadaniem podrzędnym tylko wtedy, gdy jego poprzednik jest również zadaniem podrzędnym. Domyślnie podrzędne zadanie (czyli zadanie wewnętrzne utworzone przez zadanie zewnętrzne) jest wykonywane niezależnie od elementu nadrzędnego. Można użyć AttachedToParent opcji , aby zadania nadrzędne i podrzędne zostały zsynchronizowane.

Należy pamiętać, że jeśli zadanie nadrzędne jest skonfigurowane z DenyChildAttach opcją, AttachedToParent opcja w zadaniu podrzędnym nie ma wpływu, a zadanie podrzędne zostanie wykonane jako odłączone zadanie podrzędne.

Aby uzyskać więcej informacji, zobacz Dołączone i odłączone zadania podrzędne.

DenyChildAttach 8

Określa, że każde zadanie podrzędne (czyli każde zagnieżdżone zadanie wewnętrzne utworzone przez tę kontynuację) utworzone przy AttachedToParent użyciu opcji i próby wykonania jako dołączone zadanie podrzędne nie będzie mogło dołączyć do zadania nadrzędnego i wykona zamiast tego jako odłączone zadanie podrzędne. Aby uzyskać więcej informacji, zobacz Dołączone i odłączone zadania podrzędne.

ExecuteSynchronously 524288

Określa, że zadanie kontynuacji powinno być wykonywane synchronicznie. Po określeniu tej opcji kontynuacja jest uruchamiana w tym samym wątku, który powoduje przejście zadania przednie do stanu końcowego. Jeśli poprzednik jest już ukończony po utworzeniu kontynuacji, kontynuacja zostanie uruchomiona w wątku, który tworzy kontynuację. Jeśli element antecedent CancellationTokenSource jest usuwany w finally bloku (Finally w Visual Basic), kontynuacja z tą opcją zostanie uruchomiona w tym finally bloku. Tylko bardzo krótkie kontynuacje powinny być wykonywane synchronicznie.

Ponieważ zadanie jest wykonywane synchronicznie, nie ma potrzeby wywoływania metody, takiej jak Wait() upewnienie się, że wątek wywołujący czeka na ukończenie zadania.

HideScheduler 16

Określa, że zadania utworzone przez kontynuację przez wywoływanie metod, takich jak Run(Action) lub ContinueWith(Action<Task>) zobaczą domyślny harmonogram (Default), a nie harmonogram, na którym ta kontynuacja jest uruchomiona jako bieżący harmonogram.

LazyCancellation 32

W przypadku anulowania kontynuacji uniemożliwia ukończenie kontynuacji do momentu ukończenia poprzednika.

LongRunning 2

Określa, że kontynuacja będzie długotrwałą operacją szczegółową kursu. Zapewnia wskazówkę, że TaskScheduler nadsubskrypcja może być uzasadniona.

None 0

Jeśli nie określono opcji kontynuacji, określa, że podczas wykonywania kontynuacji należy użyć domyślnego zachowania. Kontynuacja jest uruchamiana asynchronicznie, gdy zadanie antecedent zostanie ukończone, niezależnie od ostatecznej Status wartości właściwości antecedenta. Jeśli kontynuacja jest zadaniem podrzędnym, zostanie utworzone jako odłączone zagnieżdżone zadanie.

NotOnCanceled 262144

Określa, że zadanie kontynuacji nie powinno być zaplanowane, jeśli jego poprzednik został anulowany. Poprzednik jest anulowany, jeśli jego Status właściwość po zakończeniu to Canceled. Ta opcja jest nieprawidłowa w przypadku kontynuacji wielu zadań.

NotOnFaulted 131072

Określa, że zadanie kontynuacji nie powinno być zaplanowane, jeśli jego poprzednik rzucił nieobsługiwany wyjątek. Poprzednik zgłasza nieobsługiwany wyjątek, jeśli jego Status właściwość po zakończeniu to Faulted. Ta opcja jest nieprawidłowa w przypadku kontynuacji wielu zadań.

NotOnRanToCompletion 65536

Określa, że zadanie kontynuacji nie powinno być zaplanowane, jeśli jego poprzednik został uruchomiony do ukończenia. Poprzednik jest uruchamiany do ukończenia, jeśli jego Status właściwość po zakończeniu to RanToCompletion. Ta opcja jest nieprawidłowa w przypadku kontynuacji wielu zadań.

OnlyOnCanceled 196608

Określa, że kontynuacja powinna być zaplanowana tylko wtedy, gdy jego poprzednik został anulowany. Poprzednik jest anulowany, jeśli jego Status właściwość po zakończeniu to Canceled. Ta opcja jest nieprawidłowa w przypadku kontynuacji wielu zadań.

OnlyOnFaulted 327680

Określa, że zadanie kontynuacji powinno być zaplanowane tylko wtedy, gdy jego poprzednik rzucił nieobsługiwany wyjątek. Poprzednik zgłasza nieobsługiwany wyjątek, jeśli jego Status właściwość po zakończeniu to Faulted.

Opcja OnlyOnFaulted gwarantuje, że Exception właściwość w poprzedniku nie nulljest . Możesz użyć tej właściwości, aby przechwycić wyjątek i zobaczyć, który wyjątek spowodował błąd zadania. Jeśli nie uzyskujesz dostępu do Exception właściwości, wyjątek jest nieobsługiwany. Ponadto, jeśli próbujesz uzyskać dostęp do Result właściwości zadania, które zostało anulowane lub zostało uszkodzone, zostanie zgłoszony nowy wyjątek.

Ta opcja jest nieprawidłowa w przypadku kontynuacji wielu zadań.

OnlyOnRanToCompletion 393216

Określa, że kontynuacja powinna być zaplanowana tylko wtedy, gdy jego poprzednik został uruchomiony do ukończenia. Poprzednik jest uruchamiany do ukończenia, jeśli jego Status właściwość po zakończeniu to RanToCompletion. Ta opcja jest nieprawidłowa w przypadku kontynuacji wielu zadań.

PreferFairness 1

Wskazówka dla TaskScheduler zadania do zaplanowana w kolejności, w której zostały zaplanowane, tak aby zadania zaplanowane wcześniej były bardziej prawdopodobne, aby uruchamiać je wcześniej, a zaplanowane później zadania będą bardziej prawdopodobne, aby były uruchamiane później.

RunContinuationsAsynchronously 64

Określa, że zadanie kontynuacji powinno być uruchamiane asynchronicznie. Ta opcja ma pierwszeństwo przed .ExecuteSynchronously

Dotyczy