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 背景工作 關閉 方法以自行終止。 如此一來，它就不會繼續耗用使用者的記憶體和電池。 此外，相同觸發程式一次只能執行一個背景工作，因此必須先關閉先前的工作，才能觸發新的工作。

注意

背景工作是短期工作。 一般而言，您不應該在背景工作中註冊事件回呼。 如果您註冊Windows 執行階段事件，而應用程式的前景實例也會註冊該事件，則背景工作中回呼可能不可靠。