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


BackgroundTaskBuilder Класс

Определение

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

public ref class BackgroundTaskBuilder sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class BackgroundTaskBuilder final
/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class BackgroundTaskBuilder
[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
Атрибуты

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

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

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