BackgroundExecutionManager.RequestAccessAsync Metode

Definisi

Ruang nama:

Windows.ApplicationModel.Background

Overload

RequestAccessAsync()	Meminta agar aplikasi diizinkan untuk menjalankan tugas latar belakang.
RequestAccessAsync(String)	Secara asinkron meminta agar aplikasi diizinkan untuk menjalankan tugas latar belakang.

RequestAccessAsync()

Meminta agar aplikasi diizinkan untuk menjalankan tugas latar belakang.

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)

Mengembalikan

IAsyncOperation<BackgroundAccessStatus>

Ketika operasi selesai, operasi mengembalikan anggota enumerasi BackgroundAccessStatus yang menentukan hasilnya.

Atribut

OverloadAttribute RemoteAsyncAttribute

Keterangan

Versi	Aktivitas
Windows 8/Windows 8.1	Meminta pengguna dengan kotak dialog yang meminta agar aplikasi ditambahkan ke layar kunci. Harus dipanggil sebelum mendaftarkan tugas latar belakang apa pun.
Windows Phone 8.1	Tidak meminta pengguna, tetapi harus dipanggil sebelum mendaftarkan tugas latar belakang apa pun.
Windows 10	Tidak meminta pengguna, tetapi harus dipanggil sebelum mendaftarkan tugas latar belakang apa pun. Anda tidak perlu menambahkan aplikasi ke layar kunci untuk menggunakan tugas latar belakang di Windows 10, tetapi Anda masih perlu memanggil metode ini untuk meminta akses latar belakang.

Tip

Dimulai dengan Windows 10, tidak perlu lagi memanggil metode ini dari utas UI.

Lihat juga

• RequestAccessAsync(String)

RequestAccessAsync(String)

Secara asinkron meminta agar aplikasi diizinkan untuk menjalankan tugas latar belakang.

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

Pengidentifikasi aplikasi relatif paket (PRAID) aplikasi yang diizinkan untuk menjalankan tugas latar belakang. Aplikasi yang ditentukan harus berada dalam paket yang sama dengan aplikasi panggilan. Untuk informasi selengkapnya tentang PRAID, lihat atribut Id dari elemen Aplikasi .

Jika Anda menghosting tugas latar belakang di server COM di luar proses, terpisah dari aplikasi utama Anda, lalu teruskan sebagai argumen untuk applicationId PRAID aplikasi yang menentukan windows.backgroundTask ekstensi dalam manifes paketnya sendiri.

Mengembalikan

IAsyncOperation<BackgroundAccessStatus>

Operasi permintaan asinkron. Setelah berhasil diselesaikan, berisi anggota enumerasi BackgroundAccessStatus yang menentukan hasilnya.

Atribut

OverloadAttribute RemoteAsyncAttribute

Keterangan

Versi	Aktivitas
Windows 8/Windows 8.1	Meminta pengguna dengan kotak dialog yang meminta agar aplikasi ditambahkan ke layar kunci. Harus dipanggil sebelum mendaftarkan tugas latar belakang apa pun.
Windows Phone 8.1	Tidak meminta pengguna, tetapi harus dipanggil sebelum mendaftarkan tugas latar belakang apa pun.
Windows 10	Tidak meminta pengguna, tetapi harus dipanggil sebelum mendaftarkan tugas latar belakang apa pun. Anda tidak perlu menambahkan aplikasi ke layar kunci untuk menggunakan tugas latar belakang di Windows 10, tetapi Anda masih perlu memanggil metode ini, atau RequestAccessAsync, untuk meminta akses latar belakang.

Tip

Dimulai dengan Windows 10, tidak perlu lagi memanggil metode ini dari utas UI.

Lihat juga

• RequestAccessAsync