UserActivity Classe

Définition

Espace de noms:

Windows.ApplicationModel.UserActivities

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)]
/// [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

Héritage

Object Platform::Object IInspectable UserActivity

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ActivatableAttribute ThreadingAttribute

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.

Voir aussi

• Activités de l’utilisateur
• Exemple UserActivity