UserActivity Classe

Definizione

Spazio dei nomi:

Windows.ApplicationModel.UserActivities

Un oggetto UserActivity viene creato da un'app durante l'esecuzione per notificare al sistema un flusso di lavoro utente che può essere continuato in un altro dispositivo o in un altro momento nello stesso dispositivo. Fornisce informazioni su un'attività in cui l'utente è impegnato.

Nota

A partire da luglio 2021, gli utenti con cronologia attività sincronizzati tra i dispositivi Windows tramite l'account Microsoft (MSA) non avranno più l'opzione di caricare nuove attività nella sequenza temporale. Saranno comunque in grado di usare la sequenza temporale e di visualizzare la cronologia delle attività (informazioni sulle app recenti, siti Web e file) sul pc locale. Gli account connessi AAD non saranno interessati.

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

Ereditarietà

Object Platform::Object IInspectable UserActivity

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ActivatableAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 Fall Creators Update (è stato introdotto in 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v5.0)

Commenti

Nota

A partire da luglio 2021, gli utenti con cronologia attività sincronizzati tra i dispositivi Windows tramite l'account Microsoft (MSA) non avranno più l'opzione di caricare nuove attività nella sequenza temporale. Saranno comunque in grado di usare la sequenza temporale e di visualizzare la cronologia delle attività (informazioni sulle app recenti, siti Web e file) sul pc locale. Gli account connessi AAD non saranno interessati.

Un oggetto UserActivity incapsula l'attività di un utente che può essere continuata in un secondo momento e potenzialmente in un dispositivo diverso. La creazione di un'attività utente causa la possibilità di visualizzare l'attività nella sequenza temporale di Windows e nella selezione di Cortana in cui è stata interrotta la funzionalità. La sequenza temporale è una visualizzazione completa delle attività che mostra una visualizzazione cronologica di ciò che si sta lavorando, tramite attività che Windows ritiene di avere un notevole coinvolgimento degli utenti. Può anche includere ciò che si stava lavorando su tutti i dispositivi. Ad esempio, un'app di posta elettronica potrebbe creare un oggetto UserActivity quando l'utente inizia a creare un nuovo messaggio di posta elettronica. L'utente potrebbe sospendere l'uso del messaggio di posta elettronica e quindi usarlo più avanti nello stesso computer o anche in un altro dispositivo.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1803	17134	UserActivity
1803	17134	ToJson
1803	17134	ToJsonArray
1803	17134	TryParseFromJson
1803	17134	TryParseFromJsonArray
1809	17763	IsRoamable

Costruttori

UserActivity(String)

Creare un oggetto UserActivity con un ID attività specificato

Proprietà

ActivationUri	Ottiene e imposta l'URI (Uniform Resource Identifier) di attivazione.
ActivityId	Ottiene l'ID attività assegnato a userActivity quando è stato creato.
ContentInfo	Ottiene o imposta l'oggetto informazioni sul contenuto per questa attività utente.
ContentType	Ottiene e imposta il tipo MIME (Multipurpose Internet Mail Extensions) del contenuto archiviato in UserActivity.ContentUri. Ad esempio, "text/plain".
ContentUri	Ottiene e imposta l'URI (Uniform Resource Identifier) del contenuto o del documento rappresentato dall'oggetto UserActivity.
FallbackUri	Ottiene e imposta l'URI (Uniform Resource Identifier) di fallback da usare se non esiste alcun gestore per l'URI di attivazione.
IsRoamable	Ottiene e imposta se i metadati dell'attività specifica devono essere caricati in Microsoft Cloud.
State	Ottiene lo stato (pubblicato o nuovo) di questo oggetto UserActivity.
VisualElements	Ottiene informazioni che possono essere usate per il riquadro dei dettagli per questa attività.

Metodi

CreateSession()	Crea un oggetto UserActivitySession a cui verrà associata questa attività utente. È necessario chiamare questo metodo nel thread dell'interfaccia utente.
SaveAsync()	Pubblicare UserActivity.
ToJson()	Serializza userActivity in una stringa JSON. Tra le altre cose, la stringa JSON conterrà il nome visualizzato dell'app, l'URL di attivazione, l'URL del contenuto, le informazioni sul contenuto e le informazioni sull'elemento visivo, ad esempio descrizione, colore di sfondo e così via.
ToJsonArray(IIterable<UserActivity>)	Serializza una raccolta di oggetti UserActivity in una stringa JSON. Tra le altre cose, la stringa JSON conterrà il nome visualizzato dell'app, l'URL di attivazione, l'URL del contenuto, le informazioni sul contenuto e le informazioni sull'elemento visivo, ad esempio descrizione, colore di sfondo e così via per ogni UserActivity.
TryParseFromJson(String)	Costruisce un oggetto UserActivity da una stringa JSON.
TryParseFromJsonArray(String)	Crea una raccolta di oggetti UserActivity da una stringa JSON.

Vedi anche

• Attività utente
• Esempio userActivity