ConnectedServiceGrid.ConfigureServiceInstanceAsync 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.
Konfigurasikan instans layanan baik melalui dialog atau penautan ke halaman web konfigurasi.
public:
virtual System::Threading::Tasks::Task<bool> ^ ConfigureServiceInstanceAsync(Microsoft::VisualStudio::ConnectedServices::ConnectedServiceInstance ^ instance, System::Threading::CancellationToken ct);public virtual System.Threading.Tasks.Task<bool> ConfigureServiceInstanceAsync(Microsoft.VisualStudio.ConnectedServices.ConnectedServiceInstance instance, System.Threading.CancellationToken ct);abstract member ConfigureServiceInstanceAsync : Microsoft.VisualStudio.ConnectedServices.ConnectedServiceInstance * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.ConfigureServiceInstanceAsync : Microsoft.VisualStudio.ConnectedServices.ConnectedServiceInstance * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overridable Function ConfigureServiceInstanceAsync (instance As ConnectedServiceInstance, ct As CancellationToken) As Task(Of Boolean)Parameter
- instance
- ConnectedServiceInstance
Instans layanan untuk dikonfigurasi.
CancellationToken digunakan untuk membatalkan operasi konfigurasi.
Mengembalikan
Mengembalikan Tugas untuk konfigurasi. Nilai hasil Tugas menunjukkan apakah ada perubahan yang dilakukan pada instans.
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 dikonfigurasi secara sinkron sebelum metode kembali, Tugas yang dikembalikan harus ditandai sebagai selesai (misalnya, melalui Task.FromResult()).
Jika implementasi berjalan di latar belakang, implementasi dapat mengembalikan Tugas yang sedang berlangsung, dan kode Connected Services 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 konfigurasi instans, 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 perubahan pada instans yang dikonfigurasi.
Jika implementasi menunjukkan/menangani kesalahan apa pun, Tugas tidak boleh salah, 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.