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

適用対象