UserActivity Класс

Определение

Пространство имен:

Windows.ApplicationModel.UserActivities

UserActivity создается приложением во время его выполнения, чтобы уведомить систему о рабочем потоке пользователя, который может быть продолжен на другом устройстве или в другое время на том же устройстве. Он предоставляет сведения о задаче, в которую участвует пользователь.

Примечание

С июля 2021 г. пользователи, у которых журнал действий синхронизирован на всех устройствах с Windows с использованием учетной записи Майкрософт (MSA), больше не смогут отправлять новые действия в представлении временной шкалы. У таких пользователей по-прежнему будет возможность использовать временную шкалу и просматривать историю действий (сведения о последних приложениях, веб-сайтах и файлах) на своем локальном компьютере. Это не затронет учетные записи, подключенные к AAD.

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

Наследование

Object Platform::Object IInspectable UserActivity

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ActivatableAttribute ThreadingAttribute

Требования к Windows

Семейство устройств	Windows 10 Fall Creators Update (появилось в 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v5.0)

Комментарии

Примечание

С июля 2021 г. пользователи, у которых журнал действий синхронизирован на всех устройствах с Windows с использованием учетной записи Майкрософт (MSA), больше не смогут отправлять новые действия в представлении временной шкалы. У таких пользователей по-прежнему будет возможность использовать временную шкалу и просматривать историю действий (сведения о последних приложениях, веб-сайтах и файлах) на своем локальном компьютере. Это не затронет учетные записи, подключенные к AAD.

UserActivity инкапсулирует задачу пользователя, которую можно продолжить позже и, возможно, на другом устройстве. Создание действия пользователя приводит к тому, что это действие может отображаться на временной шкале Windows и в функции "Забрать, где я закончил" Кортаны. Временная шкала — это многофункциональное представление задач, которое показывает хронологическое представление о том, над чем вы работали, с помощью действий, которые, по мнению Windows, имели значительное участие пользователей. Она также может включать ваши действия на разных устройствах. Например, почтовое приложение может создать UserActivity , когда пользователь начинает создавать новое сообщение электронной почты. Пользователь может приостановить работу с сообщением электронной почты, а затем работать с ним позже на том же компьютере или даже на другом устройстве.

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
1803	17134	UserActivity
1803	17134	Tojson
1803	17134	ToJsonArray
1803	17134	TryParseFromJson
1803	17134	TryParseFromJsonArray
1809	17763	IsRoamable

Конструкторы

UserActivity(String)

Создание объекта UserActivity с указанным идентификатором действия

Свойства

ActivationUri	Возвращает и задает универсальный код ресурса (URI) активации.
ActivityId	Возвращает идентификатор действия, который был назначен этому объекту UserActivity при его создании.
ContentInfo	Возвращает или задает объект сведений о содержимом для этого действия пользователя.
ContentType	Возвращает и задает тип MIME (многоцелевых расширений электронной почты) содержимого, хранящегося в userActivity.ContentUri. Например, "text/plain".
ContentUri	Возвращает и задает универсальный код ресурса (URI) содержимого или документа, представленного userActivity.
FallbackUri	Возвращает и задает резервный универсальный код ресурса (URI), используемый при отсутствии обработчика для URI активации.
IsRoamable	Возвращает и задает, следует ли отправлять метаданные конкретного действия в Microsoft Cloud.
State	Возвращает состояние (Опубликовано или Новое) этого объекта UserActivity.
VisualElements	Возвращает сведения, которые можно использовать для плитки сведений для этого действия.

Методы

CreateSession()	Создает userActivitySession , с которым будет связано это действие пользователя. Этот метод необходимо вызвать в потоке пользовательского интерфейса.
SaveAsync()	Опубликуйте UserActivity.
ToJson()	Сериализует UserActivity в строку JSON. Помимо прочего, строка JSON будет содержать отображаемое имя приложения, URL-адрес активации, URL-адрес содержимого, сведения о содержимом и визуальные элементы, такие как описание, цвет фона и т. д.
ToJsonArray(IIterable<UserActivity>)	Сериализует коллекцию объектов UserActivity в строку JSON. Помимо прочего, строка JSON будет содержать отображаемое имя приложения, URL-адрес активации, URL-адрес содержимого, сведения о содержимом и визуальные элементы, такие как описание, цвет фона и т. д. для каждого объекта UserActivity.
TryParseFromJson(String)	Создает UserActivity из строки JSON.
TryParseFromJsonArray(String)	Создает коллекцию объектов UserActivity из строки JSON.

См. также раздел

• Действия пользователей
• Пример UserActivity