ConnectedServiceGrid.ConfigureServiceInstanceAsync Yöntem

Tanım

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<Boolean>

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.

Şunlara uygulanır