Поделиться через


UserActivity Класс

Определение

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)]
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
Наследование
Object Platform::Object IInspectable UserActivity
Атрибуты

Требования к 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.

Применяется к

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