TaskCreationOptions Enumeração

Definição

Especifica os sinalizadores que controlam o comportamento opcional para a criação e a execução de tarefas.Specifies flags that control optional behavior for the creation and execution of tasks.

Esta enumeração tem um atributo FlagsAttribute que permite uma combinação bit a bit dos seus valores membros.

public enum class TaskCreationOptions
[System.Flags]
[System.Serializable]
public enum TaskCreationOptions
type TaskCreationOptions = 
Public Enum TaskCreationOptions
Herança
TaskCreationOptions
Atributos

Campos

AttachedToParent 4

Especifica que uma tarefa seja anexada a um pai na hierarquia de tarefas.Specifies that a task is attached to a parent in the task hierarchy. Por padrão, uma tarefa filho (ou seja, uma tarefa interna criada por uma tarefa externa) é executada independentemente de seu pai.By default, a child task (that is, an inner task created by an outer task) executes independently of its parent. Use a opção AttachedToParent para que as tarefas pai e filho sejam sincronizadas.You can use the AttachedToParent option so that the parent and child tasks are synchronized.

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.Note that if a parent task is configured with the DenyChildAttach option, the AttachedToParent option in the child task has no effect, and the child task will execute as a detached child task.

Para obter mais informações, consulte Tarefas filho anexadas e desanexadas.For more information, see Attached and Detached Child Tasks.

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.Specifies that any child task that attempts to execute as an attached child task (that is, it is created with the AttachedToParent option) will not be able to attach to the parent task and will execute instead as a detached child task. Para obter mais informações, consulte Tarefas filho anexadas e desanexadas.For more information, see Attached and Detached Child Tasks.

HideScheduler 16

Impede que o agendador do ambiente seja visto como o agendador atual na tarefa criada.Prevents the ambient scheduler from being seen as the current scheduler in the created task. Isso significa que operações como StartNew ou ContinueWith executadas na tarefa criada verão Default como o agendador atual.This means that operations like StartNew or ContinueWith that are performed in the created task will see Default as the current scheduler.

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.Specifies that a task will be a long-running, coarse-grained operation involving fewer, larger components than fine-grained systems. Fornece uma dica para o TaskScheduler de que podem ser necessárias assinaturas em excesso.It provides a hint to the TaskScheduler that oversubscription may be warranted. O excesso de assinaturas lhe permite criar mais threads do que o número de threads de hardware disponíveis.Oversubscription lets you create more threads than the available number of hardware threads. 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.It also provides a hint to the task scheduler that an additional thread might be required for the task so that it does not block the forward progress of other threads or work items on the local thread-pool queue.

None 0

Especifica que o comportamento padrão deve ser usado.Specifies that the default behavior should be used.

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.A hint to a TaskScheduler to schedule a task in as fair a manner as possible, meaning that tasks scheduled sooner will be more likely to be run sooner, and tasks scheduled later will be more likely to be run later.

RunContinuationsAsynchronously 64

Força continuações adicionadas à tarefa atual a serem executadas de forma assíncrona.Forces continuations added to the current task to be executed asynchronously.

Observe que o membro RunContinuationsAsynchronously está disponível na enumeração TaskCreationOptions começando pelo .NET Framework 4.6.NET Framework 4.6.Note that the RunContinuationsAsynchronously member is available in the TaskCreationOptions enumeration starting with the .NET Framework 4.6.NET Framework 4.6.

Comentários

A TaskCreationOptions enumeração é usada com os seguintes métodos:The TaskCreationOptions enumeration is used with the following methods:

  • Os TaskFactory construtores TaskFactory<TResult> e com um creationOptions parâmetro, para especificar as opções padrão para tarefas criadas pela fábrica de tarefas.The TaskFactory and TaskFactory<TResult> constructors with a creationOptions parameter, to specify the default options for tasks created by the task factory.

  • Os Task construtores Task<TResult> e com um creationOptions parâmetro, para especificar as opções usadas para personalizar o comportamento da tarefa.The Task and Task<TResult> constructors with a creationOptions parameter, to specify the options used to customize the task's behavior.

  • Os StartNew métodos StartNew e com um creationOptions parâmetro, para especificar as opções usadas para personalizar o comportamento da tarefa.The StartNew and StartNew methods with a creationOptions parameter, to specify the options used to customize the task's behavior.

  • Os FromAsync métodos FromAsync e com um creationOptions parâmetro, para especificar as opções usadas para personalizar o comportamento da tarefa que executa um método End quando uma determinada IAsyncResult é concluída.The FromAsync and FromAsync methods with a creationOptions parameter, to specify the options used to customize the behavior of the task that executes an end method when a specified IAsyncResult completes.

  • Os TaskCompletionSource<TResult> construtores com um creationOptions parâmetro, para especificar as opções usadas para personalizar o comportamento da tarefa subjacente.The TaskCompletionSource<TResult> constructors with a creationOptions parameter, to specify the options used to customize the behavior of the underlying task.

Aplica-se a

Veja também