HostingEnvironment.QueueBackgroundWorkItem Metoda

Definicja

Przestrzeń nazw:

System.Web.Hosting

Zestaw:

System.Web.dll

Planuje zadanie, które może być uruchamiane w tle, niezależnie od dowolnego żądania.

Ta przeciążona metoda nie przepływa obiektu ExecutionContext wywołującego SecurityContext do obiektu wywołującego. W związku z tym elementy członkowskie tych obiektów, takie jak CurrentPrincipal właściwość, nie będą przepływać z obiektu wywołującego do obiektu wywołującego.

Przeciążenia

QueueBackgroundWorkItem(Action<CancellationToken>)	Planuje zadanie, które może być uruchamiane w tle, niezależnie od dowolnego żądania.
QueueBackgroundWorkItem(Func<CancellationToken,Task>)	Planuje zadanie, które może być uruchamiane w tle, niezależnie od dowolnego żądania.

QueueBackgroundWorkItem(Action<CancellationToken>)

Planuje zadanie, które może być uruchamiane w tle, niezależnie od dowolnego żądania.

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

Parametry

workItem

Action<CancellationToken>

Jednostka wykonywania.

Uwagi

Różni się od normalnego elementu roboczego ThreadPool w tym ASP.NET może śledzić liczbę elementów roboczych zarejestrowanych za pośrednictwem tego interfejsu API, a środowisko uruchomieniowe ASP.NET spróbuje opóźnić zamknięcie appDomain do momentu zakończenia wykonywania tych elementów roboczych. Tego interfejsu API nie można wywołać poza domeną aplikacji zarządzanej przez ASP.NET. Podany element CancellationToken zostanie zasygnalizowany, gdy aplikacja zostanie zamknięta.

QueueBackgroundWorkItem przyjmuje wywołanie zwrotne zwracające zadanie; element roboczy zostanie uznany za zakończony po powrocie wywołania zwrotnego.

QueueBackgroundWorkItem(Func<CancellationToken,Task>)

Planuje zadanie, które może być uruchamiane w tle, niezależnie od dowolnego żądania.

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

Parametry

workItem

Func<CancellationToken,Task>

Jednostka wykonywania.

Uwagi

Różni się od normalnego elementu roboczego ThreadPool w tym ASP.NET może śledzić liczbę elementów roboczych zarejestrowanych za pośrednictwem tego interfejsu API, a środowisko uruchomieniowe ASP.NET spróbuje opóźnić zamknięcie appDomain do momentu zakończenia wykonywania tych elementów roboczych. Tego interfejsu API nie można wywołać poza domeną aplikacji zarządzanej przez ASP.NET. Podany element CancellationToken zostanie zasygnalizowany, gdy aplikacja zostanie zamknięta.

QueueBackgroundWorkItem przyjmuje wywołanie zwrotne zwracające zadanie; element roboczy zostanie uznany za ukończony po przeniesieniu zwróconego zadania do stanu terminalu.