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)

使用指定的活動識別碼建立 UserActivity

屬性

ActivationUri	取得和設定啟用統一資源識別項 (URI) 。
ActivityId	取得建立時指派給這個 UserActivity 的活動識別碼。
ContentInfo	取得或設定這個使用者活動的內容資訊物件。
ContentType	取得和設定 MIME (Multipurpose Internet Mail Extensions) 儲存在 UserActivity.ContentUri的內容類型。 例如，「text/plain」。
ContentUri	取得和設定 UserActivity 所代表之內容或檔的內容統一資源識別項 (URI) 。
FallbackUri	取得並設定後援統一資源識別項 (URI) ，如果沒有啟用 URI 的處理常式，則為使用。
IsRoamable	取得和設定是否應該將特定活動的中繼資料上傳至 Microsoft Cloud。
State	取得此UserActivity (已發行或新增) 的狀態。
VisualElements	取得可用於此活動詳細資料磚的資訊。

方法

CreateSession()	建立與此使用者活動相關聯的 UserActivitySession 。 您必須在 UI 執行緒上呼叫這個方法。
SaveAsync()	發佈 UserActivity。
ToJson()	將 UserActivity 序列化為 JSON 字串。 此外，JSON 字串會包含應用程式顯示名稱、啟用 URL、內容 URL、內容資訊和視覺化元素資訊，例如描述、背景色彩等等。
ToJsonArray(IIterable<UserActivity>)	將 UserActivity 物件的集合序列化為 JSON 字串。 此外，JSON 字串也會包含應用程式顯示名稱、啟用 URL、內容 URL、內容資訊和視覺元素資訊，例如每個 UserActivity的描述、背景色彩等等。
TryParseFromJson(String)	從 JSON 字串建構 UserActivity 。
TryParseFromJsonArray(String)	從 JSON 字串建立 UserActivity 物件的集合。

另請參閱

• 使用者活動
• UserActivity 範例