ConnectedServiceGrid.ConfigureServiceInstanceAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Configure una instancia de servicio a través de un cuadro de diálogo o vincule a la página web de configuración.
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)Parámetros
- instance
- ConnectedServiceInstance
Instancia de servicio que se va a configurar.
CancellationToken se usa para cancelar la operación de configuración.
Devoluciones
Devuelve una tarea para la configuración. El valor de resultado de la tarea indica si se realizaron cambios en la instancia de .
Comentarios
Se garantiza que se llame a este método desde el subproceso de la interfaz de usuario y solo en los proveedores que devuelven "true" desde IsAuthenticated si se implementa un ConnectedServiceAuthenticator.
Si una implementación desea presentar la interfaz de usuario modal o de bloqueo, puede hacerlo. Si la instancia de servicio se configura de forma sincrónica antes de que el método devuelva, la tarea devuelta debe marcarse como completada (por ejemplo, a través de Task.FromResult()).
Si la implementación se ejecuta en segundo plano, puede devolver una tarea en curso y el código de servicios conectados actualizará la interfaz de usuario una vez completada la tarea. En este caso, el código de servicios conectados puede cancelar la tarea a través de CancellationToken si el usuario cierra la interfaz de usuario de Servicios concted antes de que se haya creado la instancia.
Si la implementación no supervisa o no puede supervisar la configuración de la instancia, puede devolver null. En este caso, el código de servicios conectados no hará nada y requiere que el usuario actualice o enumera manualmente las instancias de servicio para comprobar si hay cambios en la instancia configurada.
Si la implementación muestra o controla los errores, la tarea no debe producir errores en ellos ni iniciarlas como excepciones. Si la tarea devuelta se completa en un estado Defectuoso (de modo que el miembro Exception no sea NULL), la interfaz de usuario de Servicios conectados informará al usuario del error.