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 de 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 suporta o 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.Extensibilidade: A partir do Visual Studio 2022 versão 17.9, o Visual Studio oferece uma nova maneira de criar visualizadores personalizados que oferece, entre outras coisas, instalação de extensão simples 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 nos casos em que uma versão mais antiga do Visual Studio precisa ser suportada. Para obter mais informações, consulte Criar visualizadores de depurador do Visual Studio.
- Usando Microsoft.VisualStudio.DebuggerVisualizers.DialogDebuggerVisualizer: Para obter mais informações sobre essa abordagem, consulte Visualizadores personalizados.
Observação
Para criar um visualizador para objetos C/C++, veja o elemento UIVisualizer na documentação Natvis. Além disso, veja o exemplo de visualizador personalizado de C/C++ ou o exemplo de visualizador de depuração nativo de SQLite .