IBackgroundTaskInstance Schnittstelle

Referenz

Definition

Namespace:: Windows.ApplicationModel.Background

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Bietet Zugriff auf eine Hintergrundaufgabe instance.

public interface class IBackgroundTaskInstance

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(2254166650, 8664, 17779, 143, 50, 146, 138, 27, 6, 65, 246)]
struct IBackgroundTaskInstance

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(2254166650, 8664, 17779, 143, 50, 146, 138, 27, 6, 65, 246)]
public interface IBackgroundTaskInstance

Public Interface IBackgroundTaskInstance

Abgeleitet: Windows.ApplicationModel.Background.IBackgroundTaskInstance2

Windows.ApplicationModel.Background.IBackgroundTaskInstance4

Windows.UI.WebUI.WebUIBackgroundTaskInstanceRuntimeClass

Attribute: ContractVersionAttribute GuidAttribute

Windows-Anforderungen

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

Eigenschaften

InstanceId	Ruft die instance-ID der hintergrundaufgaben-instance ab.
Progress	Ruft den Status status für eine Hintergrundaufgabe instance ab oder legt diese fest.
SuspendedCount	Ruft ab, wie oft die Ressourcenverwaltungsrichtlinie dazu geführt hat, dass die Hintergrundaufgabe angehalten wurde.
Task	Ruft Zugriff auf die registrierte Hintergrundaufgabe für diese Hintergrundaufgabe instance ab.
TriggerDetails	Ruft zusätzliche Informationen ab, die einer Hintergrundaufgabe instance zugeordnet sind.

Methoden

GetDeferral()

Informiert das System darüber, dass die Hintergrundaufgabe nach dem Zurückgeben der IBackgroundTask.Run-Methode möglicherweise weiterhin Arbeiten ausführt.

Ereignisse

Canceled

Fügt einen Abbruchereignishandler an die Hintergrundaufgabe instance an.

Bei Windows Phone 8.x-App können Hintergrundaufgaben ohne Warnung und ohne Auslösen des OnCanceled-Ereignisses beendet werden, wenn auf dem Gerät wenig Arbeitsspeicher verfügbar ist. Dadurch soll die Benutzerfreundlichkeit der App im Vordergrund sichergestellt werden. Entwerfen Sie die Hintergrundaufgabe so, dass dieses Szenario behandelt werden kann. Beachten Sie, dass dies nur für Windows Phone gilt.

Gilt für: