BackgroundTaskBuilder Klasse

Definition

Namespace:

Windows.ApplicationModel.Background

Stellt eine Hintergrundaufgabe dar, die beim System registriert werden soll.

public ref class BackgroundTaskBuilder sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class BackgroundTaskBuilder final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class BackgroundTaskBuilder

function BackgroundTaskBuilder()

Public NotInheritable Class BackgroundTaskBuilder

Vererbung

Object Platform::Object IInspectable BackgroundTaskBuilder

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Hinweis

Diese Klasse ist nicht agil, was bedeutet, dass Sie das Threadingmodell und das Marshallingverhalten berücksichtigen müssen. Weitere Informationen finden Sie unter Threading and Marshaling (C++/CX) und Using Windows-Runtime objects in a multithreaded environment (.NET).

Wenn Ihre Hintergrundaufgabe Netzwerkkonnektivität erfordert, beachten Sie Folgendes:

** Netzwerkbezogene Trigger**

• Verwenden Sie einen SocketActivityTrigger, um die Hintergrundaufgabe zu aktivieren, wenn ein Paket empfangen wird und Sie eine kurzlebige Aufgabe ausführen müssen. Nach dem Ausführen der Aufgabe sollte die Hintergrundaufgabe beendet werden, um Energie zu sparen.
• Verwenden Sie einen ControlChannelTrigger, um die Hintergrundaufgabe zu aktivieren, wenn ein Paket empfangen wird und Sie eine langlebige Aufgabe ausführen müssen.

** Netzwerkbezogene Bedingungen und Flags**

• Fügen Sie der Hintergrundaufgabe die InternetAvailable-Bedingung (BackgroundTaskBuilder.AddCondition) hinzu, um das Auslösen der Hintergrundaufgabe zu verzögern, bis der Netzwerkstapel ausgeführt wird. Diese Bedingung spart Energie, da die Hintergrundaufgabe erst ausgeführt wird, wenn der Netzwerkzugriff verfügbar ist. Dieser Zustand stellt keine Aktivierung in Echtzeit bereit.

Unabhängig vom verwendeten Auslöser, legen Sie IsNetworkRequested für die Hintergrundaufgabe fest, um sicherzustellen, dass das Netzwerk während der Ausführung der Hintergrundaufgabe unterbrechungsfreie ausgeführt wird. Dies weist die Infrastruktur für Hintergrundaufgaben an, die Netzwerkverbindung für die Ausführung der Aufgabe auch dann beizubehalten, wenn sich das Gerät im verbundenen Standbymodus befindet. Wenn Ihre Hintergrundaufgabe isNetworkRequested nicht verwendet, kann Ihre Hintergrundaufgabe nicht auf das Netzwerk zugreifen, wenn sie sich im verbundenen Standbymodus befindet (z. B. wenn der Bildschirm eines Smartphones ausgeschaltet ist).

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1703	15063	TaskGroup
2004	19041	SetTaskEntryPointClsid

Konstruktoren

BackgroundTaskBuilder()

Erstellt eine instance der BackgroundTaskBuilder-Klasse.

Eigenschaften

AllowRunningTaskInStandby	Stellt eine Hintergrundaufgabe dar, die beim System registriert werden soll.
CancelOnConditionLoss	Gibt an, ob die Hintergrundaufgabe abgebrochen wird, wenn mindestens eine der erforderlichen Bedingungen nicht mehr erfüllt ist.
IsNetworkRequested	Gibt an, ob das Netzwerk während der Ausführung der Hintergrundaufgabe aktiv bleiben soll.
IsRunningTaskInStandbySupported	Stellt eine Hintergrundaufgabe dar, die beim System registriert werden soll.
Name	Ruft den Namen einer Hintergrundaufgabe ab oder legt den Namen fest.
TaskEntryPoint	Ruft die Klasse ab, die die Arbeit einer Hintergrundaufgabe ausführt, oder legt sie fest.
TaskGroup	Ruft den Gruppenbezeichner ab und legt diese fest.

Methoden

AddCondition(IBackgroundCondition)	Fügt einer Hintergrundaufgabe eine Bedingung hinzu.
Register()	Registriert eine Hintergrundaufgabe beim System.
Register(String)	Stellt eine Hintergrundaufgabe dar, die beim System registriert werden soll.
SetTaskEntryPointClsid(Guid)	Weist einen COM CLSID-Einstiegspunkt mithilfe eines vorhandenen BackgroundTaskBuilder-Objekts zu.
SetTrigger(IBackgroundTrigger)	Legt den Ereignistrigger für eine Hintergrundaufgabe fest.
Validate()	Stellt eine Hintergrundaufgabe dar, die beim System registriert werden soll.