HostingEnvironment.QueueBackgroundWorkItem Метод

Определение

Пространство имен:

System.Web.Hosting

Сборка:

System.Web.dll

Планирует задачу, которая может выполняться в фоновом режиме, независимо от какого-либо запроса.

Этот перегруженный метод не позволяет передавать ExecutionContext или SecurityContext в потоке от вызывающего к вызываемому объекту. Поэтому члены этих объектов, такие как свойство CurrentPrincipal, не будут передаваться в потоке от вызывающего к вызываемому объекту.

Перегрузки

QueueBackgroundWorkItem(Action<CancellationToken>)	Планирует задачу, которая может выполняться в фоновом режиме, независимо от какого-либо запроса.
QueueBackgroundWorkItem(Func<CancellationToken,Task>)	Планирует задачу, которая может выполняться в фоновом режиме, независимо от какого-либо запроса.

QueueBackgroundWorkItem(Action<CancellationToken>)

Планирует задачу, которая может выполняться в фоновом режиме, независимо от какого-либо запроса.

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))

Параметры

workItem

Action<CancellationToken>

Единица выполняемых действий.

Комментарии

Отличается от обычного рабочего элемента ThreadPool в этом ASP.NET может отслеживать количество рабочих элементов, зарегистрированных в данный момент с помощью этого API, и среда выполнения ASP.NET попытается отложить завершение работы appDomain до завершения выполнения этих рабочих элементов. Этот API нельзя вызывать за пределами управляемого ASP.NET домена приложения. Предоставленный CancellationToken будет сигнализироваться при завершении работы приложения.

QueueBackgroundWorkItem принимает обратный вызов, возвращающий задачу; Рабочий элемент будет считаться завершенным после возврата обратного вызова.

QueueBackgroundWorkItem(Func<CancellationToken,Task>)

Планирует задачу, которая может выполняться в фоновом режиме, независимо от какого-либо запроса.

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))

Параметры

workItem

Func<CancellationToken,Task>

Единица выполняемых действий.

Комментарии

Отличается от обычного рабочего элемента ThreadPool в этом ASP.NET может отслеживать количество рабочих элементов, зарегистрированных в данный момент с помощью этого API, и среда выполнения ASP.NET попытается отложить завершение работы appDomain до завершения выполнения этих рабочих элементов. Этот API нельзя вызывать за пределами управляемого ASP.NET домена приложения. Предоставленный CancellationToken будет сигнализироваться при завершении работы приложения.

QueueBackgroundWorkItem принимает обратный вызов, возвращающий задачу; Рабочий элемент будет считаться завершенным после перехода возвращаемой задачи в состояние терминала.