IVisualizerTargetClient.NotifyStateChangeAsync Método

Definição

Namespace:

Microsoft.VisualStudio.RpcContracts.DebuggerVisualizers

Assembly:

Microsoft.VisualStudio.RpcContracts.dll

Pacote:

Microsoft.VisualStudio.RpcContracts v17.12.12

Notifica o visualizador do depurador sobre uma alteração do estado do destino do visualizador.

public System.Threading.Tasks.Task NotifyStateChangeAsync (Microsoft.VisualStudio.RpcContracts.DebuggerVisualizers.VisualizerTargetStateNotification notification, System.Threading.CancellationToken cancellationToken);

abstract member NotifyStateChangeAsync : Microsoft.VisualStudio.RpcContracts.DebuggerVisualizers.VisualizerTargetStateNotification * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function NotifyStateChangeAsync (notification As VisualizerTargetStateNotification, cancellationToken As CancellationToken) As Task

Parâmetros

notification

VisualizerTargetStateNotification

O tipo da notificação.

cancellationToken

CancellationToken

Token de cancelamento para a chamada assíncrona.

Retornos

Task

Um Task acompanhamento da conclusão da chamada assíncrona.

Comentários

O depurador deve considerar a conclusão do retornado Task como uma indicação de que o visualizador do depurador concluiu a atualização do contexto de dados do correspondente IRemoteUserControl.

As possíveis notificações incluem:

• Alterações de disponibilidade: o destino do visualizador só estará disponível quando a sessão de depuração estiver ativa e o destino de depuração estiver em pausa. Quando o destino do visualizador não estiver disponível, as chamadas para RequestDataAsync(Nullable<ReadOnlySequence<Byte>>, CancellationToken) falharão com um VisualizerTargetUnavailableException. Quando o destino do visualizador ficar disponível novamente, o valor do objeto de destino deverá ser considerado desatualizado e deve ser recuperado novamente.
• Notificações de que o valor do objeto de destino pode ter sido alterado e deve ser recuperado novamente.