IAsyncInfo Antarmuka

Definisi

Mendukung tindakan dan operasi asinkron. IAsyncInfo adalah antarmuka dasar untuk IAsyncAction, IAsyncActionWithProgress<TProgress>, IAsyncOperation<TResult> dan IAsyncOperationWithProgress<TResult,TProgress>, yang masing-masing mendukung kombinasi jenis pengembalian dan kemajuan untuk metode asinkron.

public interface class IAsyncInfo
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(54, 0, 0, 192, 0, 0, 0, 0, 0, 0, 70)]
struct IAsyncInfo
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
[Windows.Foundation.Metadata.Guid(54, 0, 0, 192, 0, 0, 0, 0, 0, 0, 70)]
public interface IAsyncInfo
Public Interface IAsyncInfo
Turunan
Atribut

Persyaratan Windows

Rangkaian perangkat
Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract
Windows.Foundation.FoundationContract (diperkenalkan dalam v1.0)

Keterangan

IAsyncInfo adalah antarmuka yang diwariskan untuk masing-masing dari 4 antarmuka Windows Runtime yang digunakan untuk dukungan metode asinkron. Ini adalah:

Saat Anda menggunakan metode asinkron dalam kode aplikasi, Anda biasanya tidak melihat antarmuka ini sebagai nilai pengembalian. Itu karena Anda hampir selalu menggunakan sintaksis yang dapat ditunggu khusus bahasa, yang menangani antarmuka secara internal. Untuk informasi selengkapnya, lihat Pemrograman asinkron, atau salah satu panduan khusus bahasa untuk pemrograman asinkron Windows Runtime (Panggil API asinkron di C# atau Visual Basic, C++, JavaScript).

Untuk sebagian besar kode aplikasi, tidak jarang menggunakan IAsyncInfo sebagai API meskipun Anda tidak menggunakan sintaks yang dapat ditunggu. Masing-masing bahasa memiliki titik ekstensi yang umumnya lebih mudah digunakan daripada antarmuka Windows RuntimeIAsyncInfo. JavaScript memiliki sintaksis saat itu/selesai . .NET memiliki metode ekstensi AsTask , dan setelah IAsyncAction dikonversi ke Tugas, lebih mudah untuk membatalkan, mendapatkan pemberitahuan tentang penyelesaian, dan sebagainya. Untuk C++/CX, Anda dapat membungkus panggilan menggunakan runtime Konkurensi. Dengan kata lain, IAsyncInfo adalah infrastruktur tingkat runtime, yang digunakan masing-masing bahasa sebagai kerangka kerja untuk mendukung sintaks yang dapat ditunggu dengan cara mereka sendiri.

Jika Anda menerapkan tindakan kustom atau operasi kustom (skenario lanjutan) tidak menerapkan IAsyncAction secara langsung. Terapkan salah satu dari 4 antarmuka yang sebelumnya tercantum sebagai gantinya.

Properti

ErrorCode

Mendapatkan string yang menjelaskan kondisi kesalahan operasi asinkron.

Id

Mendapatkan handel operasi asinkron.

Status

Mendapatkan nilai yang menunjukkan status operasi asinkron.

Metode

Cancel()

Membatalkan operasi asinkron.

Close()

Menutup operasi asinkron.

Berlaku untuk

Lihat juga