HostingEnvironment.QueueBackgroundWorkItem Método

Definição

Namespace:

System.Web.Hosting

Assembly:

System.Web.dll

Agenda uma tarefa que pode ser executada em segundo plano, independente da solicitação.

Esse método sobrecarregado não transmite o ExecutionContext ou o SecurityContext do chamador para o computador chamado. Portanto, os membros desses objetos, como a propriedade CurrentPrincipal, não fluirão do chamador para o computador chamado.

Sobrecargas

QueueBackgroundWorkItem(Action<CancellationToken>)	Agenda uma tarefa que pode ser executada em segundo plano, independente da solicitação.
QueueBackgroundWorkItem(Func<CancellationToken,Task>)	Agenda uma tarefa que pode ser executada em segundo plano, independente da solicitação.

QueueBackgroundWorkItem(Action<CancellationToken>)

Agenda uma tarefa que pode ser executada em segundo plano, independente da solicitação.

public:
 static void QueueBackgroundWorkItem(Action<System::Threading::CancellationToken> ^ workItem);

public static void QueueBackgroundWorkItem (Action<System.Threading.CancellationToken> workItem);

static member QueueBackgroundWorkItem : Action<System.Threading.CancellationToken> -> unit

Public Shared Sub QueueBackgroundWorkItem (workItem As Action(Of CancellationToken))

Parâmetros

workItem

Action<CancellationToken>

Uma unidade de execução.

Comentários

Difere de um item de trabalho do ThreadPool normal nesse ASP.NET pode acompanhar quantos itens de trabalho registrados por meio dessa API estão em execução no momento, e o runtime do ASP.NET tentará atrasar o desligamento do AppDomain até que esses itens de trabalho tenham terminado de ser executados. Essa API não pode ser chamada fora de um AppDomain gerenciado por ASP.NET. O CancellationToken fornecido será sinalizado quando o aplicativo estiver sendo desligado.

QueueBackgroundWorkItem recebe um retorno de chamada de retorno de tarefa; o item de trabalho será considerado concluído quando o retorno de chamada retornar.

QueueBackgroundWorkItem(Func<CancellationToken,Task>)

Agenda uma tarefa que pode ser executada em segundo plano, independente da solicitação.

public:
 static void QueueBackgroundWorkItem(Func<System::Threading::CancellationToken, System::Threading::Tasks::Task ^> ^ workItem);

public static void QueueBackgroundWorkItem (Func<System.Threading.CancellationToken,System.Threading.Tasks.Task> workItem);

static member QueueBackgroundWorkItem : Func<System.Threading.CancellationToken, System.Threading.Tasks.Task> -> unit

Public Shared Sub QueueBackgroundWorkItem (workItem As Func(Of CancellationToken, Task))

Parâmetros

workItem

Func<CancellationToken,Task>

Uma unidade de execução.

Comentários

Difere de um item de trabalho do ThreadPool normal nesse ASP.NET pode acompanhar quantos itens de trabalho registrados por meio dessa API estão em execução no momento, e o runtime do ASP.NET tentará atrasar o desligamento do AppDomain até que esses itens de trabalho tenham terminado de ser executados. Essa API não pode ser chamada fora de um AppDomain gerenciado por ASP.NET. O CancellationToken fornecido será sinalizado quando o aplicativo estiver sendo desligado.

QueueBackgroundWorkItem recebe um retorno de chamada de retorno de tarefa; o item de trabalho será considerado concluído quando a Tarefa retornada fizer a transição para um estado terminal.