BackgroundTaskBuilder Classe

Definizione

Spazio dei nomi:

Windows.ApplicationModel.Background

Rappresenta un'attività in background da registrare con il 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

Ereditarietà

Object Platform::Object IInspectable BackgroundTaskBuilder

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.