UserActivity Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
- Attribute
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. |