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 辅助角色 close 方法来终止自身。 这样，它就不会继续消耗用户的内存和电池。 此外，同一触发器一次只能运行一个后台任务，因此必须先关闭上一个任务，然后才能触发新任务。

注意

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