Erstellen und Registrieren einer Hintergrundaufgabe innerhalb von Prozessen

Wichtige APIs

• IBackgroundTask
• BackgroundTaskBuilder
• BackgroundTaskCompletedEventHandler

In diesem Thema wird veranschaulicht, wie Sie eine Hintergrundaufgabe erstellen und registrieren, die im gleichen Prozess wie Ihre App ausgeführt wird.

Hintergrundaufgaben in Prozessen sind einfacher zu implementieren als Hintergrundaufgaben außerhalb von Prozessen. Sie sind jedoch weniger robust. Wenn der in einer prozessinternen Hintergrundaufgabe ausgeführte Code abstürzt, nimmt er Ihre App herunter. Beachten Sie außerdem, dass DeviceUseTrigger, DeviceServicingTrigger und IoTStartupTask nicht mit dem In-Process-Modell verwendet werden können. Die Aktivierung einer VoIP-Hintergrundaufgabe in Ihrer Anwendung ist ebenfalls nicht möglich. Diese Trigger und Aufgaben werden weiterhin mithilfe des Out-of-Process-Hintergrundaufgabenmodells unterstützt.

Beachten Sie, dass Hintergrundaktivitäten auch dann beendet werden können, wenn sie innerhalb des Vordergrundprozesses der App ausgeführt werden, wenn sie über Die Ausführungszeitlimits verfügt. Für einige Zwecke ist die Resilienz der Trennung von Arbeit in eine Hintergrundaufgabe, die in einem separaten Prozess ausgeführt wird, weiterhin nützlich. Das Trennen der Hintergrundarbeit als Aufgabe von der Vordergrundanwendung ist möglicherweise die beste Option für Arbeit, die keine Kommunikation mit der Vordergrundanwendung erfordert.

Grundlagen

Das In-Process-Modell verbessert den Anwendungslebenszyklus mit verbesserten Benachrichtigungen, wenn sich Ihre App im Vordergrund oder im Hintergrund befindet. Zwei neue Ereignisse sind über das Application-Objekt für diese Übergänge verfügbar: EnteredBackground und LeavingBackground. Diese Ereignisse passen basierend auf dem Sichtbarkeitsstatus Ihrer Anwendung in den Anwendungslebenszyklus. Weitere Informationen zu diesen Ereignissen und deren Auswirkungen auf den Anwendungslebenszyklus im App-Lebenszyklus.

Auf hoher Ebene behandeln Sie das EnteredBackground-Ereignis, um Den Code auszuführen, der ausgeführt wird, während die App im Hintergrund ausgeführt wird, und behandeln LeavingBackground, um zu wissen, wann Ihre App in den Vordergrund verschoben wurde.

Registrieren des Triggers für Hintergrundaufgaben

In-Process-Hintergrundaktivitäten werden ähnlich wie Hintergrundaktivitäten außerhalb von Prozessen registriert. Alle Hintergrundtrigger beginnen mit der Registrierung mit dem BackgroundTaskBuilder. Der Generator erleichtert die Registrierung einer Hintergrundaufgabe, indem alle erforderlichen Werte an einer zentralen Stelle festgelegt werden:

var builder = new BackgroundTaskBuilder();
builder.Name = "My Background Trigger";
builder.SetTrigger(new TimeTrigger(15, true));
// Do not set builder.TaskEntryPoint for in-process background tasks
// Here we register the task and work will start based on the time trigger.
BackgroundTaskRegistration task = builder.Register();

Bei In-Process-Hintergrundaktivitäten können Sie den Standardeinstiegspunkt nicht leer lassen TaskEntryPoint. , eine neue geschützte Methode für das Application-Objekt namens "OnBackgroundActivated()".

Sobald ein Trigger registriert ist, wird er basierend auf dem Typ des Triggers ausgelöst, der in der SetTrigger-Methode festgelegt ist. Im obigen Beispiel wird ein TimeTrigger verwendet, der fünfzehn Minuten nach der Registrierung ausgelöst wird.

Hinzufügen einer Bedingung zum Steuern, wann ihre Aufgabe ausgeführt wird (optional)

Sie können eine Bedingung hinzufügen, um zu steuern, wann die Aufgabe nach dem Auslösenereignis ausgeführt wird. Wenn die Aufgabe beispielsweise erst ausgeführt werden soll, wenn der Benutzer vorhanden ist, verwenden Sie die Bedingung UserPresent. Eine Liste der möglichen Bedingungen finden Sie unter SystemConditionType.

Der folgende Beispielcode weist eine Bedingung zu, für die der Benutzer vorhanden sein muss:

builder.AddCondition(new SystemCondition(SystemConditionType.UserPresent));

Platzieren Des Hintergrundaktivitätscodes in OnBackgroundActivated()

Platzieren Sie ihren Hintergrundaktivitätscode in OnBackgroundActivated , um auf den Hintergrundtrigger zu reagieren, wenn er ausgelöst wird. OnBackgroundActivated kann wie IBackgroundTask.Run behandelt werden. Die Methode verfügt über einen BackgroundActivatedEventArgs-Parameter , der alles enthält, was die Run-Methode bereitstellt. Beispiel: in App.xaml.cs:

using Windows.ApplicationModel.Background;

...

sealed partial class App : Application
{
  ...

  protected override void OnBackgroundActivated(BackgroundActivatedEventArgs args)
  {
      base.OnBackgroundActivated(args);
      IBackgroundTaskInstance taskInstance = args.TaskInstance;
      DoYourBackgroundWork(taskInstance);  
  }
}

Ein umfangreicheres OnBackgroundActivated-Beispiel finden Sie unter Konvertieren eines App-Diensts, der im gleichen Prozess wie die Host-App ausgeführt wird.

Behandeln des Status und Abschluss von Hintergrundaufgaben

Der Vorgangsfortschritt und der Abschluss können genauso überwacht werden wie für Mehrprozess-Hintergrundaufgaben (siehe Überwachen des Status und Abschluss von Hintergrundaufgaben), aber Sie werden wahrscheinlich feststellen, dass Sie sie einfacher nachverfolgen können, indem Sie Variablen verwenden, um den Status oder den Abschlussstatus in Ihrer App nachzuverfolgen. Dies ist einer der Vorteile, wenn Ihr Hintergrundaktivitätscode im gleichen Prozess wie Ihre App ausgeführt wird.

Behandeln des Abbruchs von Hintergrundaufgaben

In-Process-Hintergrundaufgaben werden auf die gleiche Weise abgebrochen wie Hintergrundaufgaben außerhalb von Prozessen (siehe Behandeln einer abgebrochenen Hintergrundaufgabe). Beachten Sie, dass der BackgroundActivated-Ereignishandler vor dem Abbruch beendet werden muss, oder der gesamte Prozess wird beendet. Wenn die Vordergrund-App unerwartet geschlossen wird, wenn Sie die Hintergrundaufgabe abbrechen, überprüfen Sie, ob der Handler vor dem Abbruch beendet wurde.

Das Manifest

Im Gegensatz zu Hintergrundaufgaben außerhalb von Prozessen müssen Sie dem Paketmanifest keine Hintergrundaufgabeninformationen hinzufügen, um In-Process-Hintergrundaufgaben auszuführen.

Zusammenfassung und nächste Schritte

Sie sollten nun die Grundlagen zum Schreiben einer In-Process-Hintergrundaufgabe verstehen.

In den folgenden verwandten Themen finden Sie API-Referenz, konzeptionelle Anleitungen für Hintergrundaufgaben und ausführlichere Anweisungen zum Schreiben von Apps, die Hintergrundaufgaben verwenden.

Zugehörige Themen

Ausführliche Themen zu Anleitungen zu Hintergrundaufgaben

• Konvertieren einer Hintergrundaufgabe außerhalb von Prozessen in eine In-Process-Hintergrundaufgabe
• Erstellen und Registrieren einer Hintergrundaufgabe außerhalb von Prozessen
• Wiedergeben von Medien im Hintergrund
• Reagieren auf Systemereignisse mit Hintergrundaufgaben
• Registrieren einer Hintergrundaufgabe
• Festlegen von Bedingungen zum Ausführen einer Hintergrundaufgabe
• Verwenden eines Wartungsauslösers
• Behandeln einer abgebrochenen Hintergrundaufgabe
• Überwachen des Status und Abschlusses von Hintergrundaufgaben
• Ausführen einer Hintergrundaufgabe für einen Timer

Leitfaden für Hintergrundaufgaben

• Richtlinien für Hintergrundaufgaben
• Debuggen einer Hintergrundaufgabe
• Auslösen von Anhalte-, Fortsetzungs- und Hintergrundereignissen in UWP-Apps (beim Debuggen)

Hintergrundaufgaben-API-Referenz

• Windows.ApplicationModel.Background