TaskContinuationOptions Wyliczenie
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
- 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 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 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 |