BackgroundTaskBuilder.Register Metodo

Definizione

Spazio dei nomi:

Windows.ApplicationModel.Background

Overload

Register()	Registra un'attività in background con il sistema.
Register(String)

Register()

Registra un'attività in background con il sistema.

public:
 virtual BackgroundTaskRegistration ^ Register() = Register;

BackgroundTaskRegistration Register();

public BackgroundTaskRegistration Register();

function register()

Public Function Register () As BackgroundTaskRegistration

Restituisce

BackgroundTaskRegistration

Istanza di un oggetto BackgroundTaskRegistration .

Esempio

Esempio di BackgroundTask

Commenti

L'attività deve avere un trigger di evento per il completamento del metodo Register. Il sistema pianifica l'attività in background quando si verifica l'evento trigger e tutte le relative condizioni sono state soddisfatte.

Un'attività in background out-of-process deve specificare anche un punto di ingresso attività. Per informazioni dettagliate sulla registrazione di ogni tipo di attività in background, vedere Creare e registrare un'attività in backgroundout-of-process per informazioni dettagliate sulla registrazione di ogni tipo di attività.

Convalida dei parametri dell'attività in background

Windows 8 Windows 8 non convalida i parametri impostati nell'oggetto BackgroundTaskBuilder finché il sistema tenta di eseguire l'attività in background. Se i parametri non sono validi, l'attività in background non può avviare e viene creata una voce del registro eventi.

Windows 8.1 A partire da Windows 8.1, i parametri usati per registrare l'attività in background vengono convalidati al momento della registrazione. Viene restituito un errore se la registrazione dell'attività in background ha esito negativo, consentendo all'app di determinare se l'attività in background è valida o meno. Per C# e Visual Basic, gli errori di registrazione delle attività generano in genere eccezioni .NET specifiche. Queste eccezioni vengono generate come eccezioni di prima probabilità e devono essere corrette durante lo sviluppo del codice. Le app esistenti Windows 8 in esecuzione in Windows 8.1 sono soggette a questo nuovo comportamento di sistema, che può causare l'arresto anomalo dell'app se non riesce a gestire una registrazione attività in background non riuscita. Una voce del registro eventi verrà comunque generata per la registrazione dell'attività in background non riuscita. Di conseguenza, Windows 8 app che registrano attività in background non valide devono essere riscritte per registrare correttamente le attività in background e gestire la registrazione delle attività in background non riuscite come eccezione rilevata.

Register(String)

public:
 virtual BackgroundTaskRegistration ^ Register(Platform::String ^ taskName) = Register;

/// [Windows.Foundation.Metadata.Experimental]
BackgroundTaskRegistration Register(winrt::hstring const& taskName);

[Windows.Foundation.Metadata.Experimental]
public BackgroundTaskRegistration Register(string taskName);

function register(taskName)

Public Function Register (taskName As String) As BackgroundTaskRegistration

Parametri

taskName

String

Platform::String

winrt::hstring

Restituisce

BackgroundTaskRegistration

Attributi

ExperimentalAttribute