BackgroundExecutionManager.RequestAccessAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
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)
Возвращаемое значение
После завершения операции возвращается член перечисления BackgroundAccessStatus , задающий результат.
- Атрибуты
Комментарии
Версия | Поведение |
Windows 8 и Windows 8.1; | Запрашивает у пользователя диалоговое окно, запрашивающее добавление приложения на экран блокировки. Необходимо вызвать перед регистрацией фоновых задач. |
Windows Phone 8.1 | Не запрашивает пользователя, но необходимо вызвать перед регистрацией фоновых задач. |
Windows 10 | Не запрашивает пользователя, но необходимо вызвать перед регистрацией фоновых задач. Вам не нужно добавлять приложение на экран блокировки, чтобы использовать фоновые задачи в Windows 10, но по-прежнему нужно вызвать этот метод, чтобы запросить доступ в фоновом режиме. |
Совет
Начиная с Windows 10, больше не нужно вызывать этот метод из потока пользовательского интерфейса.
См. также раздел
Применяется к
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 см. в разделе Атрибут Id элемента Application .
Если фоновые задачи размещаются на внепроцессном COM-сервере отдельно от приложения main, передайте в качестве аргумента для applicationId
PRAID приложения, определяющего windows.backgroundTask
расширение в собственном манифесте пакета.
Возвращаемое значение
Асинхронная операция запроса. При успешном завершении содержит член перечисления BackgroundAccessStatus , задающий результат.
- Атрибуты
Комментарии
Версия | Поведение |
---|---|
Windows 8 и Windows 8.1; | Запрашивает у пользователя диалоговое окно, запрашивающее добавление приложения на экран блокировки. Необходимо вызвать перед регистрацией фоновых задач. |
Windows Phone 8.1 | Не запрашивает пользователя, но необходимо вызвать перед регистрацией фоновых задач. |
Windows 10 | Не запрашивает пользователя, но необходимо вызвать перед регистрацией фоновых задач. Вам не нужно добавлять приложение на экран блокировки, чтобы использовать фоновые задачи в Windows 10, но по-прежнему необходимо вызвать этот метод или RequestAccessAsync, чтобы запросить фоновый доступ. |
Совет
Начиная с Windows 10, больше не нужно вызывать этот метод из потока пользовательского интерфейса.