Condividi tramite


BackgroundTaskBuilder Classe

Definizione

Rappresenta un'attività in background da registrare con il 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
Ereditarietà
Object Platform::Object IInspectable BackgroundTaskBuilder
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Nota

Questa classe non è agile, il che significa che è necessario considerare il modello di threading e il comportamento di marshalling. Per altre informazioni, vedere Threading e marshalling (C++/CX) e Uso di oggetti Windows Runtime in un ambiente multithreading (.NET).

Se l'attività in background richiede la connettività di rete, tenere presente quanto segue:

** Trigger correlati alla rete**

  • Usare una classe SocketActivityTrigger per attivare l'attività in background quando viene ricevuto un pacchetto ed è necessario eseguire un'attività di breve durata. Dopo aver eseguito l'attività, l'attività in background deve terminare per risparmiare energia.
  • Usare una classe ControlChannelTrigger per attivare l'attività in background quando viene ricevuto un pacchetto ed è necessario eseguire un'attività di lunga durata.

** Condizioni e flag correlati alla rete**

  • Aggiungere la condizione InternetAvailable (BackgroundTaskBuilder.AddCondition) all'attività in background per ritardare l'attivazione dell'attività in background fino a quando lo stack di rete non è in esecuzione. Questa condizione consente di risparmiare energia perché l'attività in background non verrà eseguita fino a quando non sarà disponibile l'accesso alla rete. Questa condizione non fornisce l'attivazione in tempo reale.

Indipendentemente dal trigger usato, impostare IsNetworkRequested per la tua attività in background per assicurarsi che la rete rimanga attiva durante l'esecuzione dell'attività in background. In questo modo, l'infrastruttura delle attività in background mantiene sempre attiva la rete mentre l'attività è in esecuzione, anche se il dispositivo si trova in modalità Standby connesso. Se l'attività in background non usa IsNetworkRequested, l'attività in background non sarà in grado di accedere alla rete in modalità standby connesso(ad esempio, quando lo schermo di un telefono è disattivato).

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1703 15063 TaskGroup
2004 19041 SetTaskEntryPointClsid

Costruttori

BackgroundTaskBuilder()

Crea un'istanza della classe BackgroundTaskBuilder .

Proprietà

AllowRunningTaskInStandby

Rappresenta un'attività in background da registrare con il sistema.

CancelOnConditionLoss

Indica se l'attività in background verrà annullata se almeno una delle condizioni necessarie non viene più soddisfatta.

IsNetworkRequested

Indica se mantenere attiva la rete durante l'esecuzione dell'attività in background.

IsRunningTaskInStandbySupported

Rappresenta un'attività in background da registrare con il sistema.

Name

Ottiene o imposta il nome di un'attività in background.

TaskEntryPoint

Ottiene o imposta la classe che esegue il lavoro di un'attività in background.

TaskGroup

Ottiene e imposta l'identificatore del gruppo.

Metodi

AddCondition(IBackgroundCondition)

Aggiunge una condizione a un'attività in background.

Register()

Registra un'attività in background con il sistema.

Register(String)

Rappresenta un'attività in background da registrare con il sistema.

SetTaskEntryPointClsid(Guid)

Assegna un punto di ingresso CLSID COM usando un oggetto BackgroundTaskBuilder esistente.

SetTrigger(IBackgroundTrigger)

Imposta il trigger di evento per un'attività in background.

Validate()

Rappresenta un'attività in background da registrare con il sistema.

Si applica a