Windows Dev Center

BackgroundExecutionManager Class

Erstellt Methoden, mit denen eine App fordern kann, in die App-Liste des Sperrbildschirms aufgenommen zu werden, oder mit denen die App ihre aktuellen Zugriffsmöglichkeiten auf Hintergrundaktivität und Aktualisierungen des Infofelds (Badge) im Sperrbildschirms abfragen kann.

Syntax


var backgroundExecutionManager = Windows.ApplicationModel.Background.BackgroundExecutionManager;

Attribute

[Version(0x06020000)]

Member

BackgroundExecutionManagerKlasse hat diese Membertypen:

Methoden

The BackgroundExecutionManager Klasse hat diese Methoden. Mit C#, Visual Basic und C++ erbt es auch Methoden aus Object Klasse.

MethodeBeschreibung
GetAccessStatus() Gets the ability of the calling lock screen app to perform background activity and update its badge.
GetAccessStatus(String) Gets the ability of a specific lock screen app to perform background activity and update its badge.
RemoveAccess() Removes the calling app from the lock screen's apps list.
RemoveAccess(String) Removes a specific app from the lock screen's apps list.
RequestAccessAsync() Presents the user with a dialog box that requests that the calling app be added to the lock screen.
RequestAccessAsync(String) Presents the user with a dialog box that requests that the specified app be added to the lock screen.

 

Hinweise

Da Apps, die auf Sperrbildschirm angezeigt werden, verschiedene Aufgaben im Hintergrund auszuführen dürfen, benötigen bestimmte App-Klassen den Zugriff, der über diese Klasse erfolgt, um ihre Kernszenarien auszuführen.

Ein vollständiges Beispiel, das die Verwendung dieser Klasse veranschaulicht, finden Sie im Sperrbildschirm-Beispiel in Windows Developer Center.

Beispiele

In diesem Beispiel wird gezeigt, wie Sie diese Klasse zum Hinzufügen einer App auf dem Sperrbildschirm verwenden und ihr die Funktion zuweisen, Tasks im Hintergrund auszuführen.


var Background = Windows.ApplicationModel.Background;

var promise = Background.BackgroundExecutionManager.requestAccessAsync().then(
    function(result) {
        switch (result) {
        case Background.BackgroundAccessStatus.denied:
            // Disabled by the user. 
            break;

        case Background.BackgroundAccessStatus.allowedWithAlwaysOnRealTimeConnectivity:
            // Added to list of background apps.
            // Set up background tasks; can use the network connectivity broker.
            break;

        case Background.BackgroundAccessStatus.allowedMayUseActiveRealTimeConnectivity:
            // Added to list of background apps.
            // Set up background tasks; cannot use the network connectivity broker.
            break;

        case Background.BackgroundAccessStatus.unspecified:
            // The user didn't explicitly disable or enable. 
            break;
        }
    });

Entfernen einer App aus dem Sperrbildschirm.


var Background = Windows.ApplicationModel.Background;
Background.BackgroundExecutionManager.removeAccess();

Dieses Beispiel zeigt, wie nach dem Sperrbildschirmzustand einer App abgefragt wird.


var Background = Windows.ApplicationModel.Background;

var result = Background.BackgroundApplications.getAccessStatus();
switch (result) {
case Background.BackgroundAccessStatus.denied:
    // Disabled by the user.
    // Cannot display on the lock screen or set up background tasks.
    break;

case Background.BackgroundAccessStatus.allowedWithAlwaysOnRealTimeConnectivity:
    // Added to list of background applications.
    // Can display on the lock screen.
    // Can set up background tasks and use the network connectivity broker.
    break;

case Background.BackgroundAccessStatus.allowedMayUseActiveRealTimeConnectivity:
    // Added to list of background applications.
    // Can display on the lock screen.
    // Can set up background tasks but cannot use the network connectivity broker.
    break;

case Background.BackgroundAccessStatus.unspecified:
    // The user didn't explicitly disable or enable.
    break;
}

Anforderungen

Mindestens unterstützter Client

Windows 8 [Nur Windows Store-Apps]

Mindestens unterstützter Server

Windows Server 2012 [Nur Windows Store-Apps]

Namespace

Windows.ApplicationModel.Background
Windows::ApplicationModel::Background [C++]

Metadaten

Windows.winmd

Siehe auch

Beispiel für Apps mit Sperrbildschirm

 

 

Anzeigen:
© 2015 Microsoft