ConnectedServiceGrid.CreateServiceInstanceAsync(CancellationToken) Metode
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.
Buat instans baru dari layanan.
public:
virtual System::Threading::Tasks::Task<Microsoft::VisualStudio::ConnectedServices::ConnectedServiceInstance ^> ^ CreateServiceInstanceAsync(System::Threading::CancellationToken ct);public virtual System.Threading.Tasks.Task<Microsoft.VisualStudio.ConnectedServices.ConnectedServiceInstance> CreateServiceInstanceAsync(System.Threading.CancellationToken ct);abstract member CreateServiceInstanceAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.VisualStudio.ConnectedServices.ConnectedServiceInstance>
override this.CreateServiceInstanceAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.VisualStudio.ConnectedServices.ConnectedServiceInstance>Public Overridable Function CreateServiceInstanceAsync (ct As CancellationToken) As Task(Of ConnectedServiceInstance)Parameter
CancellationToken digunakan untuk membatalkan operasi pembuatan.
Mengembalikan
Mengembalikan Tugas yang menyediakan instans layanan baru.
Keterangan
Metode ini dijamin akan dipanggil dari utas UI, dan hanya pada penyedia yang mengembalikan 'true' dari IsAuthenticated jika ConnectedServiceAuthenticator diimplementasikan.
Jika implementasi ingin menyajikan UI pemblokiran/modal, implementasi dapat melakukannya. Jika instans layanan dibuat secara sinkron sebelum metode kembali, Tugas yang dikembalikan harus ditandai sebagai selesai (kemungkinan melalui Task.FromResult()).
Jika implementasi berjalan di latar belakang, implementasi dapat mengembalikan Tugas yang sedang berlangsung, dan kode Layanan Tersambung akan menyegarkan UI setelah Tugas selesai. Dalam hal ini, kode Connected Services dapat membatalkan tugas melalui CancellationToken jika pengguna menutup UI Conencted Services sebelum instans dibuat.
Jika implementasi tidak atau tidak dapat memantau pembuatan instans baru, implementasi dapat mengembalikan null. Dalam hal ini, kode Connected Services tidak akan melakukan apa pun, dan mengharuskan pengguna untuk me-refresh/menghitung instans layanan secara manual untuk memeriksa instans yang baru dibuat.
Jika implementasi menunjukkan/menangani kesalahan apa pun, Tugas tidak boleh menyalahkannya, atau melemparkannya sebagai Pengecualian. Jika Tugas yang dikembalikan selesai dalam status Rusak (sehingga anggota Pengecualian non-null) antarmuka pengguna Connected Services akan memberi tahu pengguna tentang kegagalan tersebut.