Compartilhar via

TaskCreationOptions Enumeração

  • Referência

Definição

Namespace:
System.Threading.Tasks
Assembly:
System.Threading.Tasks.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Especifica os sinalizadores que controlam o comportamento opcional para a criação e a 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

AttachedToParent 4

Especifica que uma tarefa seja 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. Use 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 tentar ser executada como uma tarefa filho anexada (ou seja, que foi criada com a opção AttachedToParent) não poderá ser anexada à tarefa pai e será executada como uma tarefa filho desanexada. Para obter mais informações, consulte Tarefas filho anexadas e desanexadas.
HideScheduler 16

Impede que o agendador do 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.
LongRunning 2

Especifica que uma tarefa será uma operação de execução longa e de alta granularidade, envolvendo menos componentes, maiores que os de sistemas refinados. Fornece uma dica para o TaskScheduler de que podem ser necessárias assinaturas em excesso. O excesso de assinaturas lhe permite criar mais threads do que o número de threads de hardware disponíveis. Também fornece uma dica para o agendador de tarefas de que um thread adicional pode ser necessário para a tarefa, para que o progresso de outros threads ou itens de trabalho na fila do pool de threads local não seja bloqueado.
None 0

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

Uma dica para um TaskScheduler agendar uma tarefa da forma mais justa possível, o que significa que tarefas agendadas primeiro terão maior probabilidade de ser executadas primeiro, e tarefas agendadas mais tarde terão maior probabilidade de ser executadas mais tarde.
RunContinuationsAsynchronously 64

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

Observe que o RunContinuationsAsynchronously membro está disponível na TaskCreationOptions enumeração 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 pelo 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.

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

  • Os FromAsync métodos e FromAsync os 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 for 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