ConnectedServiceGrid.ConfigureServiceInstanceAsync Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Bir iletişim kutusu veya Web 'i Yapılandır sayfasına bağlantı aracılığıyla bir hizmet örneği yapılandırır.
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)
Parametreler
- instance
- ConnectedServiceInstance
Yapılandırılacak hizmet örneği.
Döndürülenler
Task<TResult>Görevin sonuç değeri, örnekte yapılan herhangi bir değişikliğin yapılıp yapılmadığını belirtir.
Açıklamalar
Bu yöntemin Kullanıcı arabirimi iş parçacığından çağrılması garanti edilir ve yalnızca true IsAuthenticated bir ConnectedServiceAuthenticator uygulanmışsa ' den dönen sağlayıcılardaki.
Uygulama, engelleme veya kalıcı Kullanıcı arabirimi kullanabilir. Hizmet, yöntem dönüşmeden önce zaman uyumlu olarak yapılandırılırsa, döndürülen görevin tamamlandı olarak işaretlenmesi gerekir (örneğin, kullanılarak FromResult ).
Uygulama arka planda çalışıyorsa, devam eden bir görevi döndürebilir ve bağlı hizmetler kodu, görev tamamlandığında Kullanıcı arabirimini yeniler. Bu durumda, örnek oluşturulmadan önce Kullanıcı, yeniden yapılandırılmış hizmetler Kullanıcı arabirimini kapatırsa, bağlı hizmetler kodu CancellationToken aracılığıyla iptal edebilir.
Uygulama arka planda çalışıyorsa, devam eden bir görevi döndürebilir ve bağlı hizmetler kodu, görev tamamlandığında Kullanıcı arabirimini yeniler. Bu durumda, örnek oluşturulmadan önce Kullanıcı, yeniden yapılandırılmış hizmetler Kullanıcı arabirimini kapatırsa, bağlı hizmetler kodu CancellationToken aracılığıyla iptal edebilir.
Uygulama örneğinin yapılandırmasını desteklemiyorsa veya izlemez, null döndürebilir. Bu durumda, bağlı hizmetler kodu hiçbir şey yapmaz ve kullanıcının yapılandırılmış örnekteki değişiklikleri denetlemek için hizmet örneklerini el ile yenilemesini veya listeletmesi gerekir.
Uygulama herhangi bir hatayı gösteriyorsa/işlediğinde, görev onlara hata içermemelidir ve özel durumlar olarak oluşturmaz. Döndürülen görev hatalı bir durumda tamamlanırsa (özel durum üyesi null olmayan) bağlı hizmetler kullanıcı ARABIRIMI, hatayı kullanıcıya bildirir.