TaskCreationOptions Enumeração

Definição

Namespace:
System.Threading.Tasks
Assemblies:
mscorlib.dll, System.Threading.Tasks.dll
Assembly:
mscorlib.dll
Assembly:
System.Threading.Tasks.dll
Assembly:
netstandard.dll

Especifica sinalizadores que controlam o comportamento opcional para a criação e execução de tarefas.

Essa enumeração dá suporte a uma combinação bit a bit dos valores de 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

Nome Valor Description
None 0

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

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

Especifica que uma tarefa será uma operação de longa execução e refinada envolvendo menos componentes maiores do que sistemas refinados. Ele fornece uma dica para que a TaskScheduler sobrescrição possa ser justificada. A sobrescrição permite criar mais threads do que o número disponível de threads de hardware. Ele também fornece uma dica para o agendador de tarefas de que um thread adicional pode ser necessário para a tarefa para que ele não bloqueie o progresso de outros threads ou itens de trabalho na fila do pool de threads local.
AttachedToParent 4

Especifica que uma tarefa é anexada a um pai na hierarquia de tarefas. Por padrão, uma tarefa filho (ou seja, uma tarefa interna criada por uma tarefa externa) é executada independentemente de seu pai. Você pode usar a opção AttachedToParent para que as tarefas pai e filho sejam sincronizadas.

Observe que, se uma tarefa pai estiver configurada com a opção DenyChildAttach , a opção AttachedToParent na tarefa filho não terá efeito e a tarefa filho será executada como uma tarefa filho desanexada.

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

Especifica que qualquer tarefa filho que tente ser executada como uma tarefa filho anexada (ou seja, ela é criada com a opção AttachedToParent ) não será capaz de anexar à tarefa pai e, em vez disso, será executada como uma tarefa filho desanexada. Para obter mais informações, consulte Tarefas filho anexadas e desanexadas.
HideScheduler 16

Impede que o agendador de ambiente seja visto como o agendador atual na tarefa criada. Isso significa que operações como StartNew ou ContinueWith executadas na tarefa criada verão Default como o agendador atual.
RunContinuationsAsynchronously 64

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

Observe que o membro RunContinuationsAsynchronously está disponível na enumeração TaskCreationOptions começando com o .NET Framework 4.6.

Comentários

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

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

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

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

  • FromAsync E FromAsync métodos 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 concluído.

  • 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

Confira também