UserActivity 類別

定義

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)]
class UserActivity final
/// [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")]
class UserActivity final
/// [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)]
public sealed class UserActivity
[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")]
public sealed class UserActivity
[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
屬性

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 物件的集合。

適用於

另請參閱