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 (String)

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 伺服器中裝載背景工作 () ，請與主要應用程式分開，然後傳遞作為應用程式之 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