Condividi tramite


UserActivity Classe

Definizione

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)]
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
Ereditarietà
Object Platform::Object IInspectable UserActivity
Attributi

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.

Si applica a

Vedi anche