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 マネージド AppDomain の外部では呼び出すことができません。 指定された 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 マネージド AppDomain の外部では呼び出すことができません。 指定された CancellationToken は、アプリケーションのシャットダウン時に通知されます。

QueueBackgroundWorkItem は、タスクを返すコールバックを受け取ります。返されたタスクが終了状態に遷移すると、作業項目は完了と見なされます。