Compartir a través de


BackgroundTaskBuilder Clase

Definición

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

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
Herencia
Object Platform::Object IInspectable BackgroundTaskBuilder
Atributos

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.

Se aplica a