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