Partager via


UserActivity Classe

Définition

Une userActivity est créée par une application pendant son exécution pour notifier le système d’un flux de travail utilisateur qui peut être poursuivi sur un autre appareil ou à un autre moment sur le même appareil. Il fournit des informations sur une tâche dans laquelle l’utilisateur est engagé.

Notes

À compter de juillet 2021, les utilisateurs dont l’historique des activités est synchronisé sur leurs appareils Windows par le biais de leur compte Microsoft (MSA) n’auront plus la possibilité de charger une nouvelle activité dans Chronologie. Ils pourront toujours utiliser Chronologie et voir l’historique de leurs activités (informations sur les applications récentes, les sites web et les fichiers) sur leur PC local. Les comptes connectés à AAD ne seront pas affectés.

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
Héritage
Object Platform::Object IInspectable UserActivity
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 Fall Creators Update (introduit dans 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v5.0)

Remarques

Notes

À compter de juillet 2021, les utilisateurs dont l’historique des activités est synchronisé sur leurs appareils Windows par le biais de leur compte Microsoft (MSA) n’auront plus la possibilité de charger une nouvelle activité dans Chronologie. Ils pourront toujours utiliser Chronologie et voir l’historique de leurs activités (informations sur les applications récentes, les sites web et les fichiers) sur leur PC local. Les comptes connectés à AAD ne seront pas affectés.

Une userActivity encapsule la tâche d’un utilisateur qui peut être poursuivie ultérieurement, et potentiellement sur un autre appareil. La création d’une activité utilisateur permet à cette activité d’apparaître dans la chronologie Windows et dans la fonctionnalité Pick up de Cortana là où je l’ai laissée. Chronologie est une vue de tâches riche qui montre une vue chronologique de ce sur quoi vous avez travaillé, via des activités qui, selon Windows, ont eu un engagement important de l’utilisateur. Il peut également inclure ce sur quoi vous travailliez sur plusieurs appareils. Par exemple, une application de messagerie peut créer un UserActivity lorsque l’utilisateur commence à créer un message électronique. L’utilisateur peut suspendre le travail sur l’e-mail, puis l’utiliser ultérieurement sur le même ordinateur, ou même sur un autre appareil.

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
1803 17134 UserActivity
1803 17134 ToJson
1803 17134 ToJsonArray
1803 17134 TryParseFromJson
1803 17134 TryParseFromJsonArray
1809 17763 IsRoamable

Constructeurs

UserActivity(String)

Créer un UserActivity avec un ID d’activité spécifié

Propriétés

ActivationUri

Obtient et définit l’URI (Uniform Resource Identifier) d’activation.

ActivityId

Obtient l’ID d’activité qui a été affecté à cet UserActivity lors de sa création.

ContentInfo

Obtient ou définit l’objet d’informations de contenu pour cette activité utilisateur.

ContentType

Obtient et définit le type MIME (Multipurpose Internet Mail Extensions) du contenu stocké dans UserActivity.ContentUri. Par exemple, « text/plain ».

ContentUri

Obtient et définit l’URI (Uniform Resource Identifier) du contenu ou du document qui est représenté par l’objet UserActivity.

FallbackUri

Obtient et définit l’URI (Uniform Resource Identifier) de secours à utiliser s’il n’existe aucun gestionnaire pour l’URI d’activation.

IsRoamable

Obtient et définit si les métadonnées de l’activité particulière doivent être chargées dans Microsoft Cloud.

State

Obtient l’état (Publié ou Nouveau) de cette UserActivity.

VisualElements

Obtient des informations qui peuvent être utilisées pour la vignette détails de cette activité.

Méthodes

CreateSession()

Crée une UserActivitySession à laquelle cette activité utilisateur sera associée. Vous devez appeler cette méthode sur le thread d’interface utilisateur.

SaveAsync()

Publiez l’élément UserActivity.

ToJson()

Sérialise userActivity dans une chaîne JSON. Entre autres choses, la chaîne JSON contient le nom d’affichage de l’application, l’URL d’activation, l’URL de contenu, les informations de contenu et les informations d’élément visuel telles que la description, la couleur d’arrière-plan, etc.

ToJsonArray(IIterable<UserActivity>)

Sérialise une collection d’objets UserActivity dans une chaîne JSON. Entre autres choses, la chaîne JSON contient le nom d’affichage de l’application, l’URL d’activation, l’URL de contenu, les informations de contenu et les informations d’élément visuel telles que la description, la couleur d’arrière-plan, etc. pour chaque UserActivity.

TryParseFromJson(String)

Construit un UserActivity à partir d’une chaîne JSON.

TryParseFromJsonArray(String)

Crée une collection d’objets UserActivity à partir d’une chaîne JSON.

S’applique à

Voir aussi