BackgroundTaskBuilder.Register 方法

定義

命名空間:

Windows.ApplicationModel.Background

多載

Register()	向系統註冊背景工作。
Register(String)

Register()

向系統註冊背景工作。

public:
 virtual BackgroundTaskRegistration ^ Register() = Register;

BackgroundTaskRegistration Register();

public BackgroundTaskRegistration Register();

function register()

Public Function Register () As BackgroundTaskRegistration

傳回

BackgroundTaskRegistration

BackgroundTaskRegistration物件的實例。

範例

BackgroundTask 範例

備註

工作必須有事件觸發程式，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);

[Windows.Foundation.Metadata.Experimental]
public BackgroundTaskRegistration Register(string taskName);

function register(taskName)

Public Function Register (taskName As String) As BackgroundTaskRegistration

參數

taskName

String

Platform::String

winrt::hstring

傳回

BackgroundTaskRegistration

屬性

ExperimentalAttribute