BackgroundExecutionManager.RequestAccessAsync 方法

定义

命名空间:

Windows.ApplicationModel.Background

重载

RequestAccessAsync()	请求允许应用运行后台任务。
RequestAccessAsync(String)	异步请求允许应用运行后台任务。

RequestAccessAsync()

请求允许应用运行后台任务。

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)

返回

IAsyncOperation<BackgroundAccessStatus>

操作完成后，它将返回指定结果的 BackgroundAccessStatus 枚举的成员。

属性

OverloadAttribute RemoteAsyncAttribute

注解

版本	行为
Windows 8/Windows 8.1	使用对话框提示用户，该对话框请求将应用添加到锁屏界面。 在注册任何后台任务之前，必须调用 。
Windows Phone 8.1	不提示用户，但必须在注册任何后台任务之前调用。
Windows 10	不提示用户，但必须在注册任何后台任务之前调用。 无需将应用添加到锁屏界面即可在 Windows 10 中使用后台任务，但仍需要调用此方法来请求后台访问。

提示

从Windows 10开始，不再需要从 UI 线程调用此方法。

另请参阅

• RequestAccessAsync (字符串)

RequestAccessAsync(String)

异步请求允许应用运行后台任务。

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)

参数

applicationId

String

Platform::String

winrt::hstring

包相对应用程序标识符 (PRAID) 允许应用运行后台任务。 指定的应用必须与调用应用位于同一包中。 有关 PRAID 的详细信息，请参阅 Application 元素的 Id 属性。

如果要在进程外 COM 服务器中托管后台任务 () ，则独立于main应用程序，请将作为应用程序 PRAID 的参数applicationId传递，该应用程序在其自己的包清单中定义扩展windows.backgroundTask。

返回

IAsyncOperation<BackgroundAccessStatus>

异步请求操作。 成功完成后，包含指定结果的 BackgroundAccessStatus 枚举的成员。

属性

OverloadAttribute RemoteAsyncAttribute

注解

版本	行为
Windows 8/Windows 8.1	使用对话框提示用户，该对话框请求将应用添加到锁屏界面。 在注册任何后台任务之前，必须调用 。
Windows Phone 8.1	不提示用户，但必须在注册任何后台任务之前调用。
Windows 10	不提示用户，但必须在注册任何后台任务之前调用。 无需将应用添加到锁屏界面即可在 Windows 10 中使用后台任务，但仍需要调用此方法或 RequestAccessAsync 来请求后台访问。

提示

从Windows 10开始，不再需要从 UI 线程调用此方法。

另请参阅

• RequestAccessAsync