Язык

BackgroundTaskBuilder Класс

Определение

Пространство имен:
Microsoft.Windows.ApplicationModel.Background
Изменить

Представляет фоновую задачу для регистрации в системе.

public ref class BackgroundTaskBuilder sealed
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.Windows.ApplicationModel.Background.BackgroundTaskContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Windows.ApplicationModel.Background.BackgroundTaskContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BackgroundTaskBuilder final
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.Windows.ApplicationModel.Background.BackgroundTaskContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Windows.ApplicationModel.Background.BackgroundTaskContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class BackgroundTaskBuilder
function BackgroundTaskBuilder()
Public NotInheritable Class BackgroundTaskBuilder
Наследование
Object Platform::Object IInspectable BackgroundTaskBuilder
Атрибуты
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Комментарии

Сведения о переносе приложений UWP с фоновыми задачами в WinUI 3 см. в руководстве по стратегии миграции фоновых задач Windows App SDK.

Этот класс не поддерживает динамическую многопоточность, что означает, что необходимо учитывать его модель потоков и поведение маршалинга. Дополнительные сведения см. в статьях "Гибкие объекты" в C++/WinRT, потоковой и маршалинге (C++/CX) ииспользовании объектов среда выполнения Windows в многопоточной среде (.NET).

Note

Во внутреннем плане BackgroundTaskBuilder использует ApplicationData.LocalSettings для хранения сведений о регистрации фоновых задач, поэтому очистка контейнера LocalSettings может повлиять на функцию ранее зарегистрированных фоновых задач. Дополнительные сведения о локальных параметрах см. в разделе "Магазин" и получение параметров и других данных приложения.

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

Имя Описание
BackgroundTaskBuilder()

Создайте объект BackgroundTaskBuilder .

Свойства

Имя Описание
Name

Возвращает или задает имя фоновой задачи.
TaskGroup

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

Методы

Имя Описание
AddCondition(IBackgroundCondition)

Добавляет условие в фоновую задачу.
Register()

Регистрирует фоновую задачу в системе.
Register(String)

Регистрирует фоновую задачу в системе.
SetTaskEntryPointClsid(Guid)

Назначает точку входа COM CLSID для фоновой задачи с помощью существующего объекта BackgroundTaskBuilder .
SetTrigger(IBackgroundTrigger)

Задает триггер события для фоновой задачи.

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

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