Compartilhar via

Criar exibições personalizadas de objetos .NET (C#, Visual Basic, F#, C++/CLI)

Você pode personalizar a maneira como o Visual Studio exibe tipos de dados em janelas variáveis do depurador.

Atributos

Em C#, Visual Basic, F#e C++ (somente código C++/CLI), você pode adicionar expansões para dados personalizados usando DebuggerDisplayAttribute, DebuggerTypeProxyAttributee DebuggerBrowsableAttribute.

No código do .NET Framework 2.0, o Visual Basic não dá suporte ao atributo DebuggerBrowsable. Essa limitação é removida em versões mais recentes do .NET.

Visualizadores

Há duas opções para criar um visualizador para um tipo .NET:

  • Usando o SDK do VisualStudio.Extensibility: A partir da versão 17.9 do Visual Studio 2022, o Visual Studio oferece uma nova maneira de criar visualizadores personalizados que proporciona, entre outras coisas, instalação simples de extensões e a capacidade de direcionar versões mais recentes do .NET. Essa opção é a API recomendada, exceto nos casos em que o visualizador e o tipo visualizado devem ser enviados juntos ou em casos em que uma versão mais antiga do Visual Studio precisa ter suporte. Para obter mais informações, confira Criar visualizadores de depurador do Visual Studio.
  • Usando Microsoft.VisualStudio.DebuggerVisualizers.DialogDebuggerVisualizer: Para obter mais informações sobre essa abordagem, consulte Visualizadores personalizados.

Nota

Para criar um visualizador para objetos C/C++, confira o elemento UIVisualizer na documentação do Natvis. Além disso, consulte o exemplo de visualizador personalizado C/C++ ou o exemplo de visualizador de depurador nativo do SQLite .

Conteúdo relacionado