WebUIBackgroundTaskInstance.Current Proprietà

Definizione

Spazio dei nomi:

Windows.UI.WebUI

Ottiene l'attività in background corrente.

public:
 static property IWebUIBackgroundTaskInstance ^ Current { IWebUIBackgroundTaskInstance ^ get(); };

static IWebUIBackgroundTaskInstance Current();

public static IWebUIBackgroundTaskInstance Current { get; }

var iWebUIBackgroundTaskInstance = WebUIBackgroundTaskInstance.current;

Public Shared ReadOnly Property Current As IWebUIBackgroundTaskInstance

Valore della proprietà

IWebUIBackgroundTaskInstance

Attività in background corrente. È possibile accedere a questa proprietà solo nel contesto di un'attività in background. Questa proprietà è Null in un'app in primo piano.

Commenti

Un'app crea un'attività in background usando la classe BackgroundTaskBuilder . Il metodo SetTrigger deve essere impostato sul trigger di evento per l'attività. TaskEntryPoint deve specificare un file JavaScript contenente il codice da eseguire. L'app registra quindi l'attività in background chiamando il metodo Register . Quando il trigger viene attivato, il sistema esegue il codice nel file JavaScript.

L'app deve anche specificare il file JavaScript nella <Extensions> sezione del manifesto dell'app. Ad esempio: <Extension Category="windows.backgroundTasks" StartPage = "js\backgroundtask.js">..

Quando viene eseguita un'attività in background, può utilizzare l'oggetto restituito dalla proprietà Current per impostare l'esito positivo o negativo dell'attività in background e accedere alle proprietà dell'attività.

Al termine del lavoro dell'attività in background, l'attività deve chiamare il metodo close di Web Worker per terminare se stesso. In questo modo non continua a utilizzare la memoria e la batteria dell'utente. Inoltre, solo un'attività in background per lo stesso trigger può essere eseguita alla volta in modo che l'attività precedente debba essere chiusa prima di attivarne una nuova.

Nota

Le attività in background devono essere attività di breve durata. In generale, non è consigliabile registrarsi per i callback di eventi in un'attività in background. Nel caso in cui si esegue la registrazione per un evento Windows Runtime e l'istanza in primo piano dell'app registri anche per tale evento, il callback nell'attività in background potrebbe non essere affidabile.