ConnectedServiceGrid.CreateServiceInstanceAsync(CancellationToken) 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í.
Cree una nueva instancia del servicio.
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)Parámetros
CancellationToken se usa para cancelar la operación de creación.
Devoluciones
Devuelve una tarea que proporciona la nueva instancia de servicio.
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 crea de forma sincrónica antes de que el método devuelva, la tarea devuelta debe marcarse como completada (probablemente 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 creación de la nueva 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 la instancia recién creada.
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.