Welcome

首页 / 软件开发 / .NET编程技术 / Windows 8 Store Apps学习(64) 后台任务: 开发一个简单的后台任务

Windows 8 Store Apps学习(64) 后台任务: 开发一个简单的后台任务2014-09-02 cnblogs webabcd介绍

重新想象 Windows 8 Store Apps 之 后台任务

开发一个简单的后台任务

示例

1、通过“Windows 运行时组件”新建一个后台任务

BackgroundTaskLib/Demo.cs

/* * 后台任务 ** 注: * 后台任务项目的输出类型需要设置为“Windows 运行时组件”,其会生成 .winmd 文件,winmd - Windows Metadata */using System;using System.Threading.Tasks;using Windows.ApplicationModel.Background;using Windows.Storage;namespace BackgroundTaskLib{// 实现 IBackgroundTask 接口,其只有一个方法,即 Run()public sealed class Demo : IBackgroundTask{public async void Run(IBackgroundTaskInstance taskInstance){// 后台任务在执行中被终止执行时所触发的事件taskInstance.Canceled += taskInstance_Canceled;// 异步操作,即通知系统后台任务可在 IBackgroundTask.Run 方法返回后继续工作BackgroundTaskDeferral deferral = taskInstance.GetDeferral();try{// 指定后台任务的进度taskInstance.Progress = 0;// taskInstance.InstanceId - 后台任务实例的唯一标识,由系统生成,与前台的 IBackgroundTaskRegistration.TaskId 一致// 写入相关数据到文件StorageFile file = await ApplicationData.Current.LocalFolder.CreateFileAsync(@"webabcdBackgroundTaskdemo.txt", CreationCollisionOption.ReplaceExisting);await FileIO.WriteTextAsync(file, "progress: 0, currentTime: " + DateTime.Now.ToString());for (uint progress = 10; progress <= 100; progress += 10){await Task.Delay(1000);// 更新后台任务的进度taskInstance.Progress = progress;// 写入相关数据到文件file = await ApplicationData.Current.LocalFolder.GetFileAsync(@"webabcdBackgroundTaskdemo.txt");await FileIO.AppendTextAsync(file, "progress: " + progress.ToString() + ", currentTime: " + DateTime.Now.ToString());}}finally{// 完成异步操作deferral.Complete();}}void taskInstance_Canceled(IBackgroundTaskInstance sender, BackgroundTaskCancellationReason reason){/* * BackgroundTaskCancellationReason - 后台任务在执行中被终止执行的原因 * Abort - 前台 app 调用了 IBackgroundTaskRegistration.Unregister(true) * Terminating - 因为系统策略,而被终止 * LoggingOff - 因为用户注销系统而被取消 * ServicingUpdate - 因为 app 更新而被取消 */}}}
2、演示后台任务的应用

BackgroundTask/Demo.xaml

<Pagex:Class="XamlDemo.BackgroundTask.Demo"xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"xmlns:local="using:XamlDemo.BackgroundTask"xmlns:d="http://schemas.microsoft.com/expression/blend/2008"xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"mc:Ignorable="d"><Grid Background="Transparent"><StackPanel Margin="120 0 0 0"><TextBlock Name="lblMsg" FontSize="14.667"/><Button Name="btnRegister" Content="注册一个后台任务" Margin="0 10 0 0" Click="btnRegister_Click_1"/><Button x:Name="btnUnregister" Content="取消注册的后台任务" Margin="0 10 0 0" Click="btnUnregister_Click_1"/></StackPanel></Grid></Page>
BackgroundTask/Demo.xaml.cs

/* * 演示后台任务的应用 ** 注: * 1、需要引用后台任务项目,后台任务的示例代码在 BackgroundTaskLib/Demo.cs * 2、需要在 Package.appxmanifest 添加“后台任务”声明,并指定 EntryPoint(后台任务的类全名) ** 另: * 关于后台任务的介绍文档请参见本目录下的 Introduction_to_Background_Tasks.docx 文件 */using System;using System.Collections.Generic;using Windows.ApplicationModel.Background;using Windows.UI.Core;using Windows.UI.Xaml;using Windows.UI.Xaml.Controls;using Windows.UI.Xaml.Navigation;namespace XamlDemo.BackgroundTask{public sealed partial class Demo : Page{// 所注册的后台任务的名称private string _taskName = "demo";// 所注册的后台任务的 EntryPoint,即后台任务的类全名// 需要在 Package.appxmanifest 添加“后台任务”声明,并指定 EntryPoint 如下:<Extension Category="windows.backgroundTasks" EntryPoint="BackgroundTaskLib.Demo"/>private string _taskEntryPoint = "BackgroundTaskLib.Demo";// 后台任务是否已在系统中注册private bool _taskRegistered = false;// 后台任务执行状况的进度说明private string _taskProgress = "";public Demo(){this.InitializeComponent();} protected override void OnNavigatedTo(NavigationEventArgs e){// 遍历所有已注册的后台任务foreach (KeyValuePair<Guid, IBackgroundTaskRegistration> task in BackgroundTaskRegistration.AllTasks){if (task.Value.Name == _taskName) // 注:后台任务的唯一标识是 IBackgroundTaskRegistration.TaskId,此处用 Name 只是为了演示方便{// 如果找到了指定的后台任务,则为其增加 Progress 和 Completed 事件监听,以便前台 app 接收后台任务的进度汇报和完成汇报AttachProgressAndCompletedHandlers(task.Value);_taskRegistered = true;break;}}UpdateUI();}private void btnRegister_Click_1(object sender, RoutedEventArgs e){// 用于构造一个后台任务BackgroundTaskBuilder builder = new BackgroundTaskBuilder();builder.Name = _taskName; // 后台任务的名称,显示用builder.TaskEntryPoint = _taskEntryPoint; // 后台任务入口点,即后台任务的类全名/* * 后台任务触发器 IBackgroundTrigger * TimeTrigger - 需要 app 在锁屏上,最小周期 15 分钟 * MaintenanceTrigger - 与 TimeTrigger 类似,但是不要求 app 在锁屏上,最小周期 15 分钟,如果 app 不在锁屏上则最快 2 小时执行一次 * SystemTrigger - 一般不要求 app 在锁屏上 * SmsReceived - 接收到新的 sms 消息时 * LockScreenApplicationAdded - app 添加到锁屏时 * LockScreenApplicationRemoved - app 从锁屏移除时 * OnlineIdConnectedStateChange - 当前连接的 Microsoft 帐户更改时 * TimeZoneChange - 时区发生更改时 * ServicingComplete - 系统完成了 app 的更新时 * ControlChannelReset - 重置控制通道时,需要 app 在锁屏上 * NetworkStateChange - 网络状态发生改变时 * InternetAvailable - Internet 变为可用时 * SessionConnected - 会话状态连接时,需要 app 在锁屏上 * 这里的 Session 指的是,用户与本机之间的 Session,也就是说当切换用户时 Session 会发生改变 * UserPresent - 用户变为活动状态时,需要 app 在锁屏上 * UserAway - 用户变为非活动状态时,需要 app 在锁屏上 * PushNotificationTrigger - 需要 app 在锁屏上。关于“推送通知”请参见:BackgroundTask/PushNotification.xaml * ControlChannelTrigger - 需要 app 在锁屏上。关于“推送通道”请参见:BackgroundTask/ControlChannel.xaml */builder.SetTrigger(new SystemTrigger(SystemTriggerType.TimeZoneChange, false));/* * 后台任务执行条件 SystemConditionType,当后台任务触发器触发后,只有满足了指定的条件才能执行 * UserPresent - 用户为活动状态 * UserNotPresent - 用户为非活动状态 * InternetAvailable - Internet 状态为可用 * InternetNotAvailable - Internet 状态为不可用 * SessionConnected - 会话状态是连接的。这里的 Session 指的是,用户与本机之间的 Session,也就是说如果系统中有用户登录则 SessionConnected * SessionDisconnected - 会话状态是断开的。这里的 Session 指的是,用户与本机之间的 Session,也就是说如果系统中没有用户登录(所有用户都注销了)则 SessionDisconnected */builder.AddCondition(new SystemCondition(SystemConditionType.InternetAvailable));// 向系统注册此后台任务BackgroundTaskRegistration task = builder.Register();// task.TaskId; 获取此后台任务的标识,一个 GUID// 为此后台任务增加 Progress 和 Completed 事件监听,以便前台 app 接收后台任务的进度汇报和完成汇报AttachProgressAndCompletedHandlers(task);_taskRegistered = true;UpdateUI();}private void btnUnregister_Click_1(object sender, RoutedEventArgs e){// 遍历所有已注册的后台任务foreach (KeyValuePair<Guid, IBackgroundTaskRegistration> task in BackgroundTaskRegistration.AllTasks){if (task.Value.Name == _taskName) // 注:后台任务的唯一标识是 IBackgroundTaskRegistration.TaskId,此处用 Name 只是为了演示方便{// 从系统中注销指定的后台任务。唯一一个参数代表如果当前后台任务正在运行中,是否需要将其取消task.Value.Unregister(true); break;}}_taskRegistered = false;UpdateUI();}private void AttachProgressAndCompletedHandlers(IBackgroundTaskRegistration task){// 为任务增加 Progress 和 Completed 事件监听,以便前台 app 接收后台任务的进度汇报和完成汇报task.Progress += new BackgroundTaskProgressEventHandler(OnProgress);task.Completed += new BackgroundTaskCompletedEventHandler(OnCompleted);}private void OnProgress(IBackgroundTaskRegistration task, BackgroundTaskProgressEventArgs args){// 获取后台任务的执行进度_taskProgress = args.Progress.ToString();UpdateUI();}private void OnCompleted(IBackgroundTaskRegistration task, BackgroundTaskCompletedEventArgs args){// 后台任务已经执行完成_taskProgress = "完成";// 如果此次后台任务的执行出现了错误,则调用 CheckResult() 后会抛出异常try{args.CheckResult();}catch (Exception ex){_taskProgress = ex.ToString();}UpdateUI();}private async void UpdateUI(){await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>{btnRegister.IsEnabled = !_taskRegistered;btnUnregister.IsEnabled = _taskRegistered;if (_taskProgress != "")lblMsg.Text = "进度:" + _taskProgress;});}}}
OK

[源码下载]:http://files.cnblogs.com/webabcd/Windows8.rar