TaskCreationOptions Enumeração

Definição

Espaço de Nomes:
System.Threading.Tasks
Assemblagens:
mscorlib.dll, System.Threading.Tasks.dll
Assemblagem:
mscorlib.dll
Assemblagem:
System.Threading.Tasks.dll
Assemblagem:
netstandard.dll

Especifica flags que controlam o comportamento opcional na criação e execução de tarefas.

Esta enumeração suporta uma combinação bit-a-bit dos respetivos valores membro.

public enum class TaskCreationOptions
[System.Flags]
public enum TaskCreationOptions
[System.Flags]
[System.Serializable]
public enum TaskCreationOptions
[<System.Flags>]
type TaskCreationOptions = 
[<System.Flags>]
[<System.Serializable>]
type TaskCreationOptions = 
Public Enum TaskCreationOptions
Herança
Object
ValueType
Enum
TaskCreationOptions
Atributos
FlagsAttribute SerializableAttribute

Campos

Name Valor Description
None 0

Especifica que o comportamento padrão deve ser utilizado.
PreferFairness 1

Uma dica para TaskScheduler agendar uma tarefa da forma mais justa possível, significando que as tarefas agendadas mais cedo terão mais probabilidade de serem executadas mais cedo, e as tarefas agendadas mais tarde terão mais probabilidade de serem executadas mais tarde.
LongRunning 2

Especifica que uma tarefa será uma operação de longa duração, de granulação grossa, envolvendo menos componentes e maiores do que sistemas de granulação fina. Dá uma pista de TaskScheduler que pode ser justificado o excesso de subscrição. A sobresubscrição permite-lhe criar mais threads do que o número disponível de threads de hardware. Também fornece uma pista ao agendador de tarefas de que pode ser necessário um thread adicional para a tarefa, para que não bloqueie o progresso de outros threads ou itens de trabalho na fila local do grupo de threads.
AttachedToParent 4

Especifica que uma tarefa está associada a um pai na hierarquia de tarefas. Por defeito, uma tarefa filha (ou seja, uma tarefa interna criada por uma tarefa externa) é executada independentemente do seu pai. Pode usar a AttachedToParent opção para que as tarefas pais e filhas estejam sincronizadas.

Note que, se uma tarefa pai estiver configurada com a DenyChildAttach opção, a AttachedToParent opção na tarefa filha não tem efeito, e a tarefa filha será executada como uma tarefa filha destacada.

Para obter mais informações, consulte Tarefas subordinadas anexadas e desanexadas.
DenyChildAttach 8

Especifica que qualquer tarefa filha que tente ser executada como tarefa filha anexada (ou seja, criada com a AttachedToParent opção) não poderá ser anexada à tarefa pai e será executada como uma tarefa filha destacada. Para obter mais informações, consulte Tarefas subordinadas anexadas e desanexadas.
HideScheduler 16

Impede que o agendador ambiente seja visto como o agendador atual na tarefa criada. Isto significa que operações como StartNew ou ContinueWith realizadas na tarefa criada serão vistas Default como o agendador atual.
RunContinuationsAsynchronously 64

Força as continuações adicionadas à tarefa atual a serem executadas de forma assíncrona.

Note-se que o membro RunContinuationsAsynchronously está disponível na enumeração TaskCreationOptions a partir do .NET Framework 4.6.

Observações

A TaskCreationOptions enumeração é usada com os seguintes métodos:

  • Os TaskFactory construtores and TaskFactory<TResult> com um creationOptions parâmetro, para especificar as opções padrão para tarefas criadas pela fábrica de tarefas.

  • Os Task construtores and Task<TResult> com um creationOptions parâmetro, para especificar as opções usadas para personalizar o comportamento da tarefa.

  • Os StartNew métodos e StartNew com um creationOptions parâmetro, para especificar as opções usadas para personalizar o comportamento da tarefa.

  • Os FromAsync métodos e FromAsync com um creationOptions parâmetro, para especificar as opções usadas para personalizar o comportamento da tarefa que executa um método final quando um especificado IAsyncResult termina.

  • Os TaskCompletionSource<TResult> construtores com um creationOptions parâmetro, para especificar as opções usadas para personalizar o comportamento da tarefa subjacente.

Aplica-se a

Ver também