BackgroundTaskBuilder.Register Méthode

Définition

Espace de noms:

Windows.ApplicationModel.Background

Surcharges

Register()	Inscrit une tâche en arrière-plan auprès du système.
Register(String)

Register()

Inscrit une tâche en arrière-plan auprès du système.

public:
 virtual BackgroundTaskRegistration ^ Register() = Register;

BackgroundTaskRegistration Register();

public BackgroundTaskRegistration Register();

function register()

Public Function Register () As BackgroundTaskRegistration

Retours

BackgroundTaskRegistration

Instance d’un objet BackgroundTaskRegistration.

Exemples

Exemple BackgroundTask

Remarques

La tâche doit avoir un déclencheur d’événement pour que la méthode Register réussisse. Le système planifie la tâche en arrière-plan lorsque son événement de déclencheur se produit et que toutes ses conditions sont remplies.

Une tâche en arrière-plan hors processus doit également spécifier un point d’entrée de tâche. Consultez Créer et inscrire une tâche en arrière-plan in-process et Créer et inscrire une tâche en arrière-plan hors processus pour plus d’informations sur l’inscription de chaque type de tâche.

Validation des paramètres de tâche en arrière-plan

Windows 8 Windows 8 ne valide pas les paramètres définis sur l’objet BackgroundTaskBuilder tant que le système n’a pas essayé d’exécuter la tâche en arrière-plan. Si les paramètres ne sont pas valides, la tâche en arrière-plan ne peut pas démarrer et une entrée de journal des événements est créée.

Windows 8.1 À compter de Windows 8.1, les paramètres utilisés pour inscrire la tâche en arrière-plan sont validés au moment de l’inscription. Une erreur est retournée si l’inscription de la tâche en arrière-plan échoue, ce qui permet à l’application de déterminer si la tâche en arrière-plan est valide ou non. Pour C# et Visual Basic, les erreurs d’inscription de tâches entraînent généralement la levée d’exceptions .NET spécifiques. Ces exceptions sont levées en tant qu’exceptions de première chance et doivent être corrigées pendant que vous développez votre code. Les applications Windows 8 existantes s’exécutant sur Windows 8.1 sont soumises à ce nouveau comportement système, ce qui peut entraîner le blocage de l’application si elle ne peut pas gérer une inscription de tâche en arrière-plan ayant échoué. (Une entrée de journal des événements est toujours générée pour l’échec de l’inscription de la tâche en arrière-plan.) Par conséquent, Windows 8 applications qui inscrivent des tâches en arrière-plan non valides doivent être réécrites pour inscrire correctement les tâches en arrière-plan et gérer l’échec de l’inscription des tâches en arrière-plan en tant qu’exception interceptée.

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

Paramètres

taskName

String

Platform::String

winrt::hstring

Retours

BackgroundTaskRegistration

Attributs

ExperimentalAttribute