BackgroundTaskBuilder Clase

Definición

Espacio de nombres:

Windows.ApplicationModel.Background

Representa una tarea en segundo plano para registrarse en el sistema.

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

Herencia

Object Platform::Object IInspectable BackgroundTaskBuilder

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

Nota:

Esta clase no es ágil, lo que significa que debe tener en cuenta su modelo de subprocesos y el comportamiento de serialización. Para obtener más información, consulte Subprocesos y serialización (C++/CX) y Uso de objetos Windows Runtime en un entorno multiproceso (.NET).

Si la tarea en segundo plano requiere conectividad de red, tenga en cuenta lo siguiente:

** Desencadenadores relacionados con la red**

• Use un SocketActivityTrigger para activar la tarea en segundo plano cuando se recibe un paquete y necesite realizar una tarea de corta duración. Después de realizar la tarea, la tarea en segundo plano debe finalizar para ahorrar energía.
• Use un ControlChannelTrigger para activar la tarea en segundo plano cuando se recibe un paquete y necesite realizar una tarea de larga duración.

** Condiciones y marcas relacionadas con la red**

• Agregue la condición InternetAvailable (BackgroundTaskBuilder.AddCondition) a la tarea en segundo plano para retrasar el desencadenamiento de la tarea en segundo plano hasta que se ejecute la pila de red. Esta condición ahorra energía porque la tarea en segundo plano no se ejecutará hasta que el acceso a la red esté disponible. Esta condición no proporciona una activación en tiempo real.

Independientemente del desencadenador que use, establezca IsNetworkRequested en la tarea en segundo plano para garantizar que la red se mantenga conectada mientras se ejecuta la tarea en segundo plano. Esto indica a la infraestructura de tareas en segundo plano que debe mantener la red mientras se esté ejecutando la tarea, incluso si el dispositivo ha entrado en modo de espera conectado. Si la tarea en segundo plano no usa IsNetworkRequested, la tarea en segundo plano no podrá acceder a la red cuando esté en modo de espera conectado (por ejemplo, cuando la pantalla de un teléfono está desactivada).

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1703	15063	TaskGroup
2004	19041	SetTaskEntryPointClsid

Constructores

BackgroundTaskBuilder()

Crea una instancia de la clase BackgroundTaskBuilder .

Propiedades

AllowRunningTaskInStandby	Representa una tarea en segundo plano para registrarse en el sistema.
CancelOnConditionLoss	Indica si la tarea en segundo plano se cancelará si ya no se cumple al menos una de sus condiciones necesarias.
IsNetworkRequested	Indica si se mantiene activa la red mientras se ejecuta la tarea en segundo plano.
IsRunningTaskInStandbySupported	Representa una tarea en segundo plano para registrarse en el sistema.
Name	Obtiene o establece el nombre de una tarea en segundo plano.
TaskEntryPoint	Obtiene o establece la clase que realiza el trabajo de una tarea en segundo plano.
TaskGroup	Obtiene y establece el identificador de grupo.

Métodos

AddCondition(IBackgroundCondition)	Agrega una condición a una tarea en segundo plano.
Register()	Registra una tarea en segundo plano con el sistema.
Register(String)	Representa una tarea en segundo plano para registrarse en el sistema.
SetTaskEntryPointClsid(Guid)	Asigna un punto de entrada CLSID COM mediante un objeto BackgroundTaskBuilder existente.
SetTrigger(IBackgroundTrigger)	Establece el desencadenador de eventos para una tarea en segundo plano.
Validate()	Representa una tarea en segundo plano para registrarse en el sistema.