IBackgroundTaskInstance2 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. Erbt von der IBackgroundTaskInstance-Schnittstelle und fügt die GetThrottleCount-Methode hinzu.

public interface class IBackgroundTaskInstance2 : IBackgroundTaskInstance

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1333592438, 3190, 20404, 137, 109, 93, 225, 134, 65, 34, 246)]
struct IBackgroundTaskInstance2 : IBackgroundTaskInstance

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(1333592438, 3190, 20404, 137, 109, 93, 225, 134, 65, 34, 246)]
public interface IBackgroundTaskInstance2 : IBackgroundTaskInstance

Public Interface IBackgroundTaskInstance2
Implements IBackgroundTaskInstance

Attribute: ContractVersionAttribute GuidAttribute

Implementiert: IBackgroundTaskInstance

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. (Geerbt von IBackgroundTaskInstance)
Progress	Ruft den Status status für eine Hintergrundaufgabe instance ab oder legt diese fest. (Geerbt von IBackgroundTaskInstance)
SuspendedCount	Ruft ab, wie oft die Ressourcenverwaltungsrichtlinie dazu geführt hat, dass die Hintergrundaufgabe angehalten wurde. (Geerbt von IBackgroundTaskInstance)
Task	Ruft Zugriff auf die registrierte Hintergrundaufgabe für diese Hintergrundaufgabe instance ab. (Geerbt von IBackgroundTaskInstance)
TriggerDetails	Ruft zusätzliche Informationen ab, die einer Hintergrundaufgabe instance zugeordnet sind. (Geerbt von IBackgroundTaskInstance)

Methoden

GetDeferral()	Informiert das System darüber, dass die Hintergrundaufgabe nach dem Zurückgeben der IBackgroundTask.Run-Methode möglicherweise weiterhin Arbeiten ausführt. (Geerbt von IBackgroundTaskInstance)
GetThrottleCount(BackgroundTaskThrottleCounter)	Ruft ab, wie oft die Hintergrundaufgabe angehalten wurde, wenn zu viele Ressourcen verwendet werden.

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.

(Geerbt von IBackgroundTaskInstance)

Gilt für:

Weitere Informationen

IBackgroundTaskInstance