BackgroundTaskBuilder.Register Methode

Definition

Namespace:

Windows.ApplicationModel.Background

Überlädt

Register()	Registriert eine Hintergrundaufgabe beim System.
Register(String)

Register()

Registriert eine Hintergrundaufgabe beim System.

public:
 virtual BackgroundTaskRegistration ^ Register() = Register;

BackgroundTaskRegistration Register();

public BackgroundTaskRegistration Register();

function register()

Public Function Register () As BackgroundTaskRegistration

Gibt zurück

BackgroundTaskRegistration

Eine instance eines BackgroundTaskRegistration-Objekts.

Beispiele

BackgroundTask-Beispiel

Hinweise

Der Task muss über einen Ereignistrigger verfügen, damit die Register-Methode erfolgreich ist. Das System plant die Hintergrundaufgabe, wenn das Triggerereignis auftritt und alle Bedingungen erfüllt wurden.

Eine Hintergrundaufgabe außerhalb des Prozesses muss auch einen Aufgabeneinstiegspunkt angeben. Ausführliche Informationen zum Registrieren jeder Art von Aufgaben finden Sie unter Erstellen und Registrieren einer Hintergrundaufgabe im Prozess undErstellen und Registrieren einer Hintergrundaufgabe außerhalb des Prozesses .

Überprüfung des Hintergrundtasksparameters

Windows 8 Windows 8 überprüft die für das BackgroundTaskBuilder-Objekt festgelegten Parameter erst, wenn das System versucht, die Hintergrundaufgabe auszuführen. Wenn die Parameter ungültig sind, kann die Hintergrundaufgabe nicht gestartet werden, und ein Ereignisprotokolleintrag wird erstellt.

Windows 8.1 Ab Windows 8.1 werden die Parameter, die zum Registrieren der Hintergrundaufgabe verwendet werden, zum Zeitpunkt der Registrierung überprüft. Ein Fehler wird zurückgegeben, wenn die Registrierung der Hintergrundaufgabe fehlschlägt, sodass die App bestimmen kann, ob die Hintergrundaufgabe gültig ist. Bei C# und Visual Basic führen Aufgabenregistrierungsfehler in der Regel dazu, dass bestimmte .NET-Ausnahmen ausgelöst werden. Diese Ausnahmen werden als First-Chance-Ausnahmen ausgelöst und sollten korrigiert werden, während Sie Ihren Code noch entwickeln. Vorhandene Windows 8 Apps, die auf Windows 8.1 ausgeführt werden, unterliegen diesem neuen Systemverhalten, das dazu führen kann, dass die App abstürzt, wenn sie eine fehlgeschlagene Registrierung von Hintergrundaufgaben nicht verarbeiten kann. (Für die Registrierung der fehlerhaften Hintergrundaufgabe wird weiterhin ein Ereignisprotokolleintrag generiert.) Daher sollten Windows 8 Apps, die ungültige Hintergrundaufgaben registrieren, neu geschrieben werden, um Hintergrundaufgaben ordnungsgemäß zu registrieren und die Registrierung fehlerhafter Hintergrundaufgaben als abgefangene Ausnahme zu behandeln.

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

Parameter

taskName

String

Platform::String

winrt::hstring

Gibt zurück

BackgroundTaskRegistration

Attribute

ExperimentalAttribute