Visión general

La extensión Diagnostics Explorer de VisualStudio.Extensibility está diseñada para ayudar a depurar las extensiones de VisualStudio.Extensibility durante su desarrollo. La audiencia de destino de esta extensión es autores de extensiones, no consumidores de extensiones. Esta extensión proporciona una interfaz para inspeccionar los puntos de extensibilidad con los que interactúan las extensiones, así como los objetos de configuración que estas proporcionan al IDE y los metadatos de esos objetos de configuración.

Comenzar

Siga estas instrucciones para instalar, iniciar y configurar el Explorador de Diagsnotics.

Instalación de la extensión

Puede obtener el Explorador de Diagnósticos directamente a través del Administrador de extensiones en Visual Studio o desde el Marketplace de Visual Studio aquí.

Abrir el Explorador de diagnósticos en Visual Studio

Para iniciar el VisualStudio.Extensibility Diagnostics Explorer en Visual Studio, seleccione VisualStudio.Extensibility Diagnostics Explorer en el menú Extensiones.

Habilitación de la recopilación de diagnósticos

El Explorador de diagnósticos está configurado para recopilar datos de diagnóstico pertinentes de las extensiones de forma predeterminada. Si desea deshabilitar o volver a habilitar esta recopilación de datos, puede activar la casilla Habilitar recopilación de diagnósticos en la esquina inferior izquierda de la ventana de herramientas. Se requiere un reinicio de Visual Studio para que los cambios en esta configuración surtan efecto.

Páginas de diagnóstico

El panel izquierdo de la ventana de la herramienta Explorador de diagnósticos contiene una lista de distintas páginas de diagnóstico . Hay dos tipos de páginas de diagnóstico: características extensibles e infraestructura de extensibilidad. Las páginas de características extensibles proporcionan información de diagnóstico sobre un componente extensible específico dentro de Visual Studio, como comandos. Las páginas de infraestructura de extensibilidad proporcionan información de diagnóstico relevante independientemente de los puntos de extensibilidad a los que se conecta su extensión. La página Eventos, un visor en directo para eventos relacionados con la extensibilidad, y la página Contextos de Cliente, que muestra el estado de IDE pertinente para ayudarle a crear restricciones de activación, son las dos páginas de infraestructura de extensibilidad.

Páginas de características extensibles

Las páginas de características extensibles tienen un ComboBox en la esquina superior izquierda para los diferentes puntos de extensibilidad en esa área de características, cada uno de los cuales se puede asignar directamente a los objetos de configuración de la extensión. Por ejemplo, en la página Comandos hay un Punto de extensibilidad para Menús y barras de herramientas, que muestra cada uno de los menús y barras de herramientas que Visual Studio descubrió en sus extensiones VisualStudio.Extensibility.

Los datos se actualizan en tiempo real a medida que las propiedades se actualizan en extensiones. Por ejemplo, si una extensión cambia el nombre para mostrar de uno de sus comandos en tiempo de ejecución, el nuevo nombre para mostrar de ese comando se muestra inmediatamente en la columna Nombre para mostrar para ese comando.

El Punto de Extensibilidad ComboBox también tiene un elemento llamado Log, que le muestra una vista en vivo de esas actualizaciones. El botón Borrar todo situado junto al ComboBox puede usarse para borrar todas las líneas que actualmente se muestran en la vista.

Puede filtrar los elementos de la vista utilizando la Extensions ComboBox. Cuando se selecciona Todos en este ComboBox, se muestran los datos de cada extensión de VisualStudio.Extensibility instalada. Si cambia este ComboBox al identificador de una extensión específica, solo se muestran los elementos relacionados con esa extensión específica. El valor de este ComboBox se conserva incluso cuando se navega entre páginas de características extensibles.

Algunas celdas de la pantalla DataGrid [Haga clic para expandir]. Este mensaje significa que los metadatos relacionados con esa propiedad son demasiado detallados para mostrarse perfectamente en una celda de DataGrid. Al hacer clic en la celda, se abre un cuadro de diálogo modal que muestra el valor real de esa celda.

Páginas de infraestructura extensible

Página Eventos

La página de eventos muestra cuándo ocurre "algo" en el IDE. Cada evento aparece como una nueva fila en DataGrid, junto con las propiedades relacionadas con ese evento. Por ejemplo, cuando se ejecuta un comando, aparece un evento Commands - Executing en la vista que muestra el identificador de la extensión a la que pertenece el comando y el identificador del comando que se ejecutó.

Puede usar el Event ComboBox para filtrar la vista para que solo contenga eventos con un nombre específico. Cuando se selecciona Todo, se muestran todos los eventos. Si se selecciona un evento específico, todas las propiedades del evento se muestran en la vista. Algunas propiedades deben expandirse haciendo clic en [Haga clic para expandir] si son demasiado detallados para mostrarse en una sola celda.

El Contract ComboBox filtra la vista para mostrar solo eventos relacionados con una característica extensible específica. También filtra el Event ComboBox para que solo contenga los nombres de eventos relacionados con la característica extensible específica.

Al hacer clic en el botón Borrar todo, se eliminan todos los eventos que se muestran actualmente en la vista.

Descripciones de columnas

Id. de extensión

La columna ID de extensión muestra el identificador de la extensión con la que está relacionada la instancia del evento. Es posible que esta celda esté vacía para algunos eventos si no pertenecen a una extensión específica, sino que se aplican al IDE en su conjunto.

Id. de elemento

La columna Identificador de elemento muestra el ID del elemento de extensión al que está relacionada la instancia del evento. Por ejemplo, el id. de elemento para los comandos de : ejecutar evento sería el identificador del comando que se ejecutó.

Propiedades

La columna Propiedades muestra el conjunto de propiedades relacionadas con esa instancia del evento que se podría mostrar en una sola celda de un DataGrid. Las propiedades más detalladas solo serían visibles desde el cuadro de diálogo Más información o cambiando el Evento de ComboBox por el nombre del evento específico que le interesa.

Más información

La columna Más información muestra metadatos más detallados relacionados con un evento. Al hacer clic en una celda de esta columna, se abre un cuadro de diálogo modal que contiene todos los metadatos relacionados con el evento representado por esa fila.

Página Contextos de cliente

La página contextos de cliente muestra el estado de varias propiedades relacionadas con el propio IDE. El Contexto de ComboBox cambia los datos de la vista para mostrar todas las restricciones de activación relacionadas con el elemento seleccionado actualmente en Contextos de Cliente de ComboBox, o un registro de todas las veces que han cambiado estas propiedades desde que se abrió la ventana de herramientas. Cuando se selecciona el contexto eventos , se puede usar el botón Borrar todo para eliminar todos los eventos que se muestran actualmente en la vista.