BackgroundTaskBuilder.Register 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
Register() |
向系統註冊背景工作。 |
Register(String) |
Register()
向系統註冊背景工作。
public:
virtual BackgroundTaskRegistration ^ Register() = Register;
BackgroundTaskRegistration Register();
public BackgroundTaskRegistration Register();
function register()
Public Function Register () As BackgroundTaskRegistration
傳回
BackgroundTaskRegistration物件的實例。
範例
備註
工作必須有事件觸發程式,Register 方法才能成功。 當觸發程式事件發生且符合其所有條件時,系統會排程背景工作。
跨進程背景工作也必須指定工作進入點。 如需註冊每種工作的詳細資訊,請參閱建立和註冊進程內背景工作和建立和註冊跨進程背景工作。
背景工作參數驗證
Windows 8 Windows 8不會驗證BackgroundTaskBuilder物件上設定的參數,直到系統嘗試執行背景工作為止。 如果參數無效,背景工作就無法啟動並建立事件記錄專案。
Windows 8.1從 Windows 8.1 開始,在註冊時會驗證用來註冊背景工作的參數。 如果背景工作註冊失敗,則會傳回錯誤,讓應用程式判斷背景工作是否有效。 針對 C# 和 Visual Basic,工作註冊錯誤通常會導致擲回特定的 .NET 例外狀況。 這些例外狀況會擲回為第一個機率例外狀況,而且應該在仍在開發程式碼時加以更正。在Windows 8.1上執行的現有Windows 8應用程式受限於這個新的系統行為,如果應用程式無法處理失敗的背景工作註冊,可能會導致應用程式當機。 (仍會產生失敗背景工作註冊的事件記錄檔專案。) 因此 Windows 8,註冊無效背景工作的應用程式應該重寫為正確註冊背景工作,並處理失敗的背景工作註冊作為攔截的例外狀況。
適用於
Register(String)
public:
virtual BackgroundTaskRegistration ^ Register(Platform::String ^ taskName) = Register;
/// [Windows.Foundation.Metadata.Experimental]
BackgroundTaskRegistration Register(winrt::hstring const& taskName);
BackgroundTaskRegistration Register(winrt::hstring const& taskName);
[Windows.Foundation.Metadata.Experimental]
public BackgroundTaskRegistration Register(string taskName);
public BackgroundTaskRegistration Register(string taskName);
function register(taskName)
Public Function Register (taskName As String) As BackgroundTaskRegistration
參數
- taskName
-
String
Platform::String
winrt::hstring
傳回
- 屬性