WebUIBackgroundTaskInstance.Current プロパティ

定義

名前空間:

Windows.UI.WebUI

現在のバックグラウンド タスクを取得します。

public:
 static property IWebUIBackgroundTaskInstance ^ Current { IWebUIBackgroundTaskInstance ^ get(); };

static IWebUIBackgroundTaskInstance Current();

public static IWebUIBackgroundTaskInstance Current { get; }

var iWebUIBackgroundTaskInstance = WebUIBackgroundTaskInstance.current;

Public Shared ReadOnly Property Current As IWebUIBackgroundTaskInstance

プロパティ値

IWebUIBackgroundTaskInstance

現在のバックグラウンド タスク。 このプロパティには、バックグラウンド タスクのコンテキストでのみアクセスできます。 フォアグラウンド アプリでは、このプロパティは null です。

注釈

アプリは BackgroundTaskBuilder クラスを使用してバックグラウンド タスクを作成します。 SetTrigger メソッドは、タスクのイベント トリガーに設定する必要があります。 TaskEntryPoint では、実行するコードを含む JavaScript ファイルを指定する必要があります。 その後、アプリは Register メソッドを呼び出してバックグラウンド タスクを 登録 します。 トリガーが起動すると、システムは JavaScript ファイル内のコードを実行します。

アプリでは、アプリ マニフェストのセクションで <Extensions> JavaScript ファイルも指定する必要があります。 たとえば、 <Extension Category="windows.backgroundTasks" StartPage = "js\backgroundtask.js">.と指定します。

バックグラウンド タスクを実行すると、Current プロパティから返されたオブジェクトを使用して、バックグラウンド タスクの成功または失敗を設定したり、タスクのプロパティにアクセスしたりできます。

バックグラウンド タスクの作業が完了したら、タスクは Web Workers close メソッドを呼び出して終了する必要があります。 このようにすると、ユーザーのメモリとバッテリーが消費され続けられません。 また、同じトリガーに対して一度に実行できるバックグラウンド タスクは 1 つだけであるため、新しいタスクをトリガーするには、前のタスクを閉じる必要があります。

Note

バックグラウンド タスクは、有効期間の短いタスクを対象とします。 一般に、バックグラウンド タスクでイベント コールバックに登録しないでください。 Windows ランタイム イベントに登録し、アプリのフォアグラウンド インスタンスもそのイベントに登録する場合、バックグラウンド タスクのコールバックが信頼できない可能性があります。