UserActivity 类

定义

命名空间:

Windows.ApplicationModel.UserActivities

UserActivity 由应用在执行期间创建，以通知系统用户工作流，该工作流可以在另一台设备上继续，或在同一设备上其他时间继续。 它提供有关用户参与的任务的信息。

注意

从 2021 年 7 月开始，通过其 Microsoft 帐户 (MSA) 跨其 Windows 设备共享了活动历史记录的用户将无法再在时间线中删除新活动。 他们将仍可在其本地电脑上使用时间线并查看其活动历史记录（最近使用的应用、网站和文件的相关信息）。 AAD 连接的帐户将不受影响。

public ref class UserActivity sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(Windows.ApplicationModel.UserActivities.IUserActivityFactory, 393216, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class UserActivity final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.ApplicationModel.UserActivities.IUserActivityFactory), 393216, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class UserActivity

function UserActivity(activityId)

Public NotInheritable Class UserActivity

继承

Object Platform::Object IInspectable UserActivity

属性

ContractVersionAttribute MarshalingBehaviorAttribute ActivatableAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 Fall Creators Update (在 10.0.16299.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v5.0 中引入)

注解

注意

从 2021 年 7 月开始，通过其 Microsoft 帐户 (MSA) 跨其 Windows 设备共享了活动历史记录的用户将无法再在时间线中删除新活动。 他们将仍可在其本地电脑上使用时间线并查看其活动历史记录（最近使用的应用、网站和文件的相关信息）。 AAD 连接的帐户将不受影响。

UserActivity 封装了用户的任务，该任务可以在以后继续，并可能在不同的设备上继续。 创建 用户活动 会导致该活动能够显示在 Windows 时间线和 Cortana 的“我离开的位置”功能中。 时间线是一个丰富的任务视图，它通过 Windows 认为具有显著用户参与度的活动，按时间顺序显示你正在处理的内容。 它还包括你在各种不同设备上执行的操作。 例如，当用户开始创建新电子邮件时，邮件应用可以创建 UserActivity 。 用户可以暂停处理电子邮件，然后稍后在同一台计算机甚至另一台设备上处理电子邮件。

版本历史记录

Windows 版本	SDK 版本	增值
1803	17134	UserActivity
1803	17134	ToJson
1803	17134	ToJsonArray
1803	17134	TryParseFromJson
1803	17134	TryParseFromJsonArray
1809	17763	IsRoamable

构造函数

UserActivity(String)

创建具有指定活动 ID 的 UserActivity

属性

ActivationUri	获取并设置激活统一资源标识符 (URI) 。
ActivityId	获取创建时分配给此 UserActivity 的活动 ID。
ContentInfo	获取或设置此用户活动的内容信息对象。
ContentType	获取和设置 MIME (多用途 Internet 邮件扩展) 存储在 UserActivity.ContentUri 中的内容的类型。 例如，“text/plain”。
ContentUri	获取和设置由 UserActivity 表示的内容或文档的内容统一资源标识符 (URI) 。
FallbackUri	获取并设置回退统一资源标识符 (URI) 在激活 URI 没有处理程序时使用。
IsRoamable	获取并设置是否应将特定活动的元数据上传到 Microsoft 云。
State	获取此 UserActivity (已发布或新) 的状态。
VisualElements	获取可用于此活动的详细信息磁贴的信息。

方法

CreateSession()	创建此用户活动将与之关联的 UserActivitySession 。 必须在 UI 线程上调用此方法。
SaveAsync()	发布 UserActivity。
ToJson()	将 UserActivity 序列化为 JSON 字符串。 除其他事项外，JSON 字符串将包含应用显示名称、激活 URL、内容 URL、内容信息和可视元素信息（如说明、背景色等）。
ToJsonArray(IIterable<UserActivity>)	将 UserActivity 对象的集合序列化为 JSON 字符串。 除其他事项外，JSON 字符串将包含每个 UserActivity 的应用显示名称、激活 URL、内容 URL、内容信息和可视元素信息（如说明、背景色等）。
TryParseFromJson(String)	从 JSON 字符串构造 UserActivity 。
TryParseFromJsonArray(String)	从 JSON 字符串创建 UserActivity 对象的集合。

另请参阅

• 用户活动
• UserActivity 示例