UserActivity Klasse

  • Referenz

Definition

Namespace:
Windows.ApplicationModel.UserActivities
Bearbeiten

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)]
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
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.

Gilt für:

Weitere Informationen