WebUIBackgroundTaskInstance.Current 属性

定义

获取当前后台任务。

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

属性值

当前后台任务。 只能在后台任务的上下文中访问此属性。 此属性在前台应用中为 null。

注解

应用使用 BackgroundTaskBuilder 类创建后台任务。 SetTrigger 方法必须设置为任务的事件触发器。 TaskEntryPoint 必须指定包含要运行的代码的 JavaScript 文件。 然后,应用通过调用 Register 方法注册后台任务。 触发触发器时,系统会执行 JavaScript 文件中的代码。

应用还必须在 <Extensions> 应用清单的 部分中指定 JavaScript 文件。 例如:<Extension Category="windows.backgroundTasks" StartPage = "js\backgroundtask.js">.

运行后台任务时,可以使用从 Current 属性返回的对象来设置后台任务的成功或失败,并访问任务的属性。

后台任务完成其工作后,该任务必须调用 Web 辅助角色 close 方法来终止自身。 这样,它就不会继续消耗用户的内存和电池。 此外,同一触发器一次只能运行一个后台任务,因此必须先关闭上一个任务,然后才能触发新任务。

注意

后台任务是指生存期较短的任务。 通常,不应在后台任务中注册事件回调。 如果注册了Windows 运行时事件,并且应用的前景实例也注册了该事件,则后台任务中的回调可能不可靠。

适用于