Freigeben über


BackgroundExecutionManager.RequestAccessAsync Methode

Definition

Überlädt

RequestAccessAsync()

Fordert an, dass die App Hintergrundaufgaben ausführen darf.

RequestAccessAsync(String)

Fordert asynchron an, dass die App Hintergrundaufgaben ausführen darf.

RequestAccessAsync()

Fordert an, dass die App Hintergrundaufgaben ausführen darf.

public:
 static IAsyncOperation<BackgroundAccessStatus> ^ RequestAccessAsync();
/// [Windows.Foundation.Metadata.Overload("RequestAccessAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<BackgroundAccessStatus> RequestAccessAsync();
[Windows.Foundation.Metadata.Overload("RequestAccessAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<BackgroundAccessStatus> RequestAccessAsync();
function requestAccessAsync()
Public Shared Function RequestAccessAsync () As IAsyncOperation(Of BackgroundAccessStatus)

Gibt zurück

Nach Abschluss des Vorgangs wird ein Element der BackgroundAccessStatus-Enumeration zurückgegeben, das das Ergebnis angibt.

Attribute

Hinweise

VersionVerhalten
Windows 8/Windows 8.1Fordert den Benutzer mit einem Dialogfeld auf, das anfordert, dem Sperrbildschirm eine App hinzuzufügen. Muss vor dem Registrieren von Hintergrundaufgaben aufgerufen werden.
Windows Phone 8.1Fordert den Benutzer nicht auf, muss jedoch aufgerufen werden, bevor Hintergrundaufgaben registriert werden.
Windows 10Fordert den Benutzer nicht auf, muss jedoch aufgerufen werden, bevor Hintergrundaufgaben registriert werden. Sie müssen die App nicht zum Sperrbildschirm hinzufügen, um Hintergrundaufgaben in Windows 10 verwenden zu können, aber Sie müssen diese Methode trotzdem aufrufen, um den Hintergrundzugriff anzufordern.

Tipp

Ab Windows 10 ist es nicht mehr erforderlich, diese Methode aus dem UI-Thread aufzurufen.

Weitere Informationen

Gilt für:

RequestAccessAsync(String)

Fordert asynchron an, dass die App Hintergrundaufgaben ausführen darf.

public:
 static IAsyncOperation<BackgroundAccessStatus> ^ RequestAccessAsync(Platform::String ^ applicationId);
/// [Windows.Foundation.Metadata.Overload("RequestAccessForApplicationAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<BackgroundAccessStatus> RequestAccessAsync(winrt::hstring const& applicationId);
[Windows.Foundation.Metadata.Overload("RequestAccessForApplicationAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<BackgroundAccessStatus> RequestAccessAsync(string applicationId);
function requestAccessAsync(applicationId)
Public Shared Function RequestAccessAsync (applicationId As String) As IAsyncOperation(Of BackgroundAccessStatus)

Parameter

applicationId
String

Platform::String

winrt::hstring

Der paketrelative Anwendungsbezeichner (PRAID) der App, die zum Ausführen von Hintergrundaufgaben zugelassen werden soll. Die angegebene App muss sich im selben Paket wie die aufrufende App befinden. Weitere Informationen zur PRAID finden Sie im Id-Attribut des Application-Elements .

Wenn Sie Hintergrundaufgaben auf einem com-Server aus einem out-of-Process-Server hosten, geben Sie getrennt von Ihrer Standard-Anwendung als Argument für applicationId die PRAID der Anwendung, die die windows.backgroundTask Erweiterung in ihrem eigenen Paketmanifest definiert.

Gibt zurück

Ein asynchroner Anforderungsvorgang. Enthält bei erfolgreicher Fertigstellung ein Element der BackgroundAccessStatus-Enumeration , das das Ergebnis angibt.

Attribute

Hinweise

Version Verhalten
Windows 8/Windows 8.1 Fordert den Benutzer mit einem Dialogfeld auf, das anfordert, dem Sperrbildschirm eine App hinzuzufügen. Muss vor dem Registrieren von Hintergrundaufgaben aufgerufen werden.
Windows Phone 8.1 Fordert den Benutzer nicht auf, muss jedoch aufgerufen werden, bevor Hintergrundaufgaben registriert werden.
Windows 10 Fordert den Benutzer nicht auf, muss jedoch aufgerufen werden, bevor Hintergrundaufgaben registriert werden. Sie müssen die App nicht zum Sperrbildschirm hinzufügen, um Hintergrundaufgaben in Windows 10 verwenden zu können, aber Sie müssen trotzdem diese Methode oder RequestAccessAsync aufrufen, um Hintergrundzugriff anzufordern.

Tipp

Ab Windows 10 ist es nicht mehr erforderlich, diese Methode aus dem UI-Thread aufzurufen.

Weitere Informationen

Gilt für: