UserActivity Klasse

Definition

Namespace:

Windows.ApplicationModel.UserActivities

Eine UserActivity wird während der Ausführung von einer App erstellt, um das System über einen Benutzerarbeitsdatenstrom zu benachrichtigen, der auf einem anderen Gerät oder zu einem anderen Zeitpunkt auf demselben Gerät fortgesetzt werden kann. Sie enthält Informationen zu einer Aufgabe, mit der der Benutzer beschäftigt ist.

Hinweis

Ab Juli 2021 haben Benutzer, deren Aktivitätsverlauf auf ihren Windows-Geräten über ihr Microsoft-Konto (MSA) synchronisiert wird, nicht mehr die Möglichkeit, neue Aktivitäten auf die Zeitachse hochzuladen. Sie können die Zeitachse weiterhin verwenden und ihren Aktivitätsverlauf (Informationen zu aktuellen Apps, Websites und Dateien) auf ihrem lokalen PC anzeigen. Mit AAD verbundene Konten sind nicht betroffen.

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

Vererbung

Object Platform::Object IInspectable UserActivity

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ActivatableAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 Fall Creators Update (eingeführt in 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v5.0)

Hinweise

Hinweis

Ab Juli 2021 haben Benutzer, deren Aktivitätsverlauf auf ihren Windows-Geräten über ihr Microsoft-Konto (MSA) synchronisiert wird, nicht mehr die Möglichkeit, neue Aktivitäten auf die Zeitachse hochzuladen. Sie können die Zeitachse weiterhin verwenden und ihren Aktivitätsverlauf (Informationen zu aktuellen Apps, Websites und Dateien) auf ihrem lokalen PC anzeigen. Mit AAD verbundene Konten sind nicht betroffen.

Eine UserActivity kapselt die Aufgabe eines Benutzers, die zu einem späteren Zeitpunkt und möglicherweise auf einem anderen Gerät fortgesetzt werden kann. Das Erstellen einer Benutzeraktivität bewirkt, dass diese Aktivität in der Windows-Zeitachse und in Cortanas Feature "Pick up where I left off" angezeigt werden kann. Die Zeitachse ist eine umfangreiche Aufgabenansicht, die eine chronologische Ansicht dessen anzeigt, worüber Sie gearbeitet haben, über Aktivitäten, von denen Windows glaubt, dass sie eine erhebliche Benutzerbindung hatten. Es kann auch das enthalten, worüber Sie auf allen Geräten gearbeitet haben. Beispielsweise könnte eine Mail-App eine UserActivity erstellen, wenn der Benutzer mit dem Erstellen einer neuen E-Mail-Nachricht beginnt. Der Benutzer kann die Arbeit an der E-Mail anhalten und später auf demselben Computer oder sogar auf einem anderen Gerät daran arbeiten.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1803	17134	UserActivity
1803	17134	ToJson
1803	17134	ToJsonArray
1803	17134	TryParseFromJson
1803	17134	TryParseFromJsonArray
1809	17763	IsRoamable

Konstruktoren

UserActivity(String)

Erstellen einer UserActivity mit einer angegebenen Aktivitäts-ID

Eigenschaften

ActivationUri	Ruft den Aktivierungs-URI (Uniform Resource Identifier) ab und legt diese fest.
ActivityId	Ruft die Aktivitäts-ID ab, die dieser UserActivity zugewiesen wurde, als sie erstellt wurde.
ContentInfo	Ruft das Inhaltsinformationsobjekt für diese Benutzeraktivität ab oder legt es fest.
ContentType	Ruft den MIME-Typ (Multipurpose Internet Mail Extensions) des unter UserActivity.ContentUri gespeicherten Inhalts ab und legt diese fest. Beispiel: "text/plain".
ContentUri	Ruft den URI (Uniform Resource Identifier) des Inhalts oder Dokuments ab, der durch die UserActivity dargestellt wird, und legt diesen fest.
FallbackUri	Ruft den Fallback-URI (Uniform Resource Identifier) ab, der verwendet werden soll, wenn kein Handler für den Aktivierungs-URI vorhanden ist, und legt diesen fest.
IsRoamable	Ruft ab und legt fest, ob die Metadaten der jeweiligen Aktivität in die Microsoft Cloud hochgeladen werden sollen.
State	Ruft den Status (Veröffentlicht oder Neu) dieser UserActivity ab.
VisualElements	Ruft Informationen ab, die für die Detailkachel für diese Aktivität verwendet werden können.

Methoden

CreateSession()	Erstellt eine UserActivitySession , der diese Benutzeraktivität zugeordnet wird. Sie müssen diese Methode im UI-Thread aufrufen.
SaveAsync()	Veröffentlichen Sie die UserActivity.
ToJson()	Serialisiert die UserActivity in eine JSON-Zeichenfolge. Die JSON-Zeichenfolge enthält unter anderem den Anzeigenamen der App, die Aktivierungs-URL, die Inhalts-URL, Inhaltsinformationen und visuelle Elementinformationen wie Beschreibung, Hintergrundfarbe usw.
ToJsonArray(IIterable<UserActivity>)	Serialisiert eine Auflistung von UserActivity-Objekten in eine JSON-Zeichenfolge. Die JSON-Zeichenfolge enthält unter anderem den Anzeigenamen der App, die Aktivierungs-URL, die Inhalts-URL, Inhaltsinformationen und visuelle Elementinformationen wie Beschreibung, Hintergrundfarbe usw. für jede UserActivity.
TryParseFromJson(String)	Erstellt eine UserActivity aus einer JSON-Zeichenfolge.
TryParseFromJsonArray(String)	Erstellt eine Auflistung von UserActivity-Objekten aus einer JSON-Zeichenfolge.

Weitere Informationen

• Benutzeraktivitäten
• UserActivity-Beispiel