BackgroundTaskBuilder Класс

Определение

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

Windows.ApplicationModel.Background

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

public ref class BackgroundTaskBuilder sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class BackgroundTaskBuilder final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class BackgroundTaskBuilder

function BackgroundTaskBuilder()

Public NotInheritable Class BackgroundTaskBuilder

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

Object Platform::Object IInspectable BackgroundTaskBuilder

Атрибуты

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

Примечание

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

Если для фоновой задачи требуется сетевое подключение, имейте в виду следующее:

** Триггеры, связанные с сетью**

• Используйте SocketActivityTrigger, чтобы активировать фоновую задачу при получении пакета и возникновении необходимости выполнить кратковременную задачу. После выполнения задачи фоновая задача должна завершить работу для экономии электроэнергии.
• Используйте ControlChannelTrigger, чтобы активировать фоновую задачу при получении пакета и возникновении необходимости выполнить долговременную задачу.

** Условия и флаги, связанные с сетью**

• Добавьте условие InternetAvailable (BackgroundTaskBuilder.AddCondition) в фоновую задачу, чтобы отложить запуск фоновой задачи до выполнения сетевого стека. Это условие экономит электроэнергию, так как фоновая задача не будет выполняться, пока не будет доступен доступ к сети. Это условие не поддерживает активацию в режиме реального времени.

Независимо от используемого триггера задайте условие IsNetworkRequested для фоновой задачи, чтобы обеспечить сохранность подключения к сети, пока выполняется фоновая задача. Это указывает инфраструктуре фоновых задач на необходимость поддержания соединения во время выполнения задачи, даже если устройство переходит в режим ожидания с подключением. Если фоновая задача не использует IsNetworkRequested, то фоновая задача не сможет получить доступ к сети в режиме ожидания с подключением (например, при отключенном экране телефона).

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

Версия Windows	Версия пакета SDK	Добавленная стоимость
1703	15063	Группа задач
2004	19041	SetTaskEntryPointClsid

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

BackgroundTaskBuilder()

Создает экземпляр класса BackgroundTaskBuilder .

Свойства

AllowRunningTaskInStandby	Представляет фоновую задачу для регистрации в системе.
CancelOnConditionLoss	Указывает, будет ли фоновая задача отменена, если хотя бы одно из ее обязательных условий больше не выполняется.
IsNetworkRequested	Указывает, следует ли поддерживать сеть во время выполнения фоновой задачи.
IsRunningTaskInStandbySupported	Представляет фоновую задачу для регистрации в системе.
Name	Возвращает или задает имя фоновой задачи.
TaskEntryPoint	Возвращает или задает класс, выполняющий работу фоновой задачи.
TaskGroup	Возвращает и задает идентификатор группы.

Методы

AddCondition(IBackgroundCondition)	Добавляет условие в фоновую задачу.
Register()	Регистрирует фоновую задачу в системе.
Register(String)	Представляет фоновую задачу для регистрации в системе.
SetTaskEntryPointClsid(Guid)	Назначает точку входа COM CLSID с помощью существующего объекта BackgroundTaskBuilder.
SetTrigger(IBackgroundTrigger)	Задает триггер события для фоновой задачи.
Validate()	Представляет фоновую задачу для регистрации в системе.