IAsyncInfo Antarmuka
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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:
- IAsyncAction
- IAsyncActionWithProgress<TProgress>
- IAsyncOperation<TResult>
- IAsyncOperationWithProgress<TResult,TProgress>
Saat 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, jarang menggunakan IAsyncInfo sebagai API meskipun Anda tidak menggunakan sintaks yang dapat ditunggu. Setiap 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 penanganan operasi asinkron. |
Status |
Mendapatkan nilai yang menunjukkan status operasi asinkron. |
Metode
Cancel() |
Membatalkan operasi asinkron. |
Close() |
Menutup operasi asinkron. |
Berlaku untuk
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk