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
返回
- 属性