BackgroundExecutionManager.RequestAccessAsync Methode
Definition
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.
Ü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
| 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 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.