Ejemplo Debugger Views Application
Actualización: noviembre 2007
En este ejemplo se muestra una característica que se incluye con Microsoft Visual Studio 2005: la función que permite cambiar la manera de ver las clases en las ventanas de depuración. Aplicando a una clase y a sus miembros los nuevos atributos como DebuggerDisplayAttribute, es posible controlar la forma en que se muestran las columnas de valor, tipo y nombre para ese tipo en la ventana de depuración Variables locales, y si se muestra, se oculta o se expande un valor cuando éste se visualiza. En este momento, este ejemplo solo está disponible en Microsoft Visual C# 2005.
Para obtener información sobre el uso de los ejemplos, vea los temas siguientes:
En este ejemplo se incluyen archivos de código fuente para tres clases que contienen los atributos del depurador y archivos de código fuente que no los contienen, tal y como se muestra en la siguiente tabla.
Archivos con atributos del depurador |
Archivos sin atributos del depurador |
|---|---|
DebugAddress.cs |
NonDebugAddress.cs |
DebugCustomer.cs |
NonDebugCustomer.cs |
DebugCustomerName.cs |
NonDebugCustomerName.cs |
El archivo DebuggerViewsExample.cs contiene el punto de entrada de la aplicación de consola y lo utilizan ambos grupos de archivos. Quite los comentarios del código en las versiones de depuración (DebugAddress.cs, DebugCustomer.cs y DebugCustomerName.cs) para ejecutar el ejemplo.
Para generar el ejemplo desde el símbolo del sistema
Abra una ventana del símbolo del sistema y navegue hasta el subdirectorio \CS bajo el directorio DebuggerViewsCS. Para obtener información sobre la configuración requerida y el símbolo del sistema de SDK, vea Cómo: Establecer la configuración de los ejemplos.
Escriba msbuild DebuggerViewsCS.sln en la línea de comandos.
.gif "Nota")
Nota:Este ejemplo muestra una serie de características de Visual Studio. Para poder ver su resultado, debe iniciarlo y ejecutarlo dentro del entorno de depuración de Visual Studio.
Para generar el ejemplo utilizando Visual Studio
Abra el Explorador de Windows y navegue hasta el subdirectorio \CS bajo el directorio DebuggerViewsCS.
Haga doble clic en DebuggerViewsCS.sln para abrir el archivo en Visual Studio 2005.
En el menú Generar, haga clic en Generar solución.
Para ejecutar el ejemplo
En el menú Ver de Visual Studio, haga clic en Explorador de soluciones.
En la ventana del Explorador de soluciones, haga doble clic en DebuggerViewsExample.cs para abrir el archivo en Visual Studio 2005.
En el menú Proyecto, haga clic en Mostrar todos los archivos.
Inserte un punto de interrupción (presionando F9) en la línea en la que el método GetCustomers crea una instancia de una variable de tipo Customer, tal como se muestra a continuación:
Customer c = new Customer(cn, Address.GetAddressById(customerAddresses, cn.Id));
Presione F5 para iniciar y ejecutar la aplicación de ejemplo en el entorno de depuración de Visual Studio 2005.
Cuando la aplicación se interrumpa en el punto de interrupción, presione F10 para pasar a la siguiente línea de código.
Observe los valores actuales en la ventana Variables locales expandiendo la jerarquía de las propiedades, colecciones y otros objetos de la aplicación. Para mostrar la ventana Variables locales, haga clic en Ventanas en el menú Depurar y, a continuación, haga clic en Variables locales.
En el menú Depurar, haga clic en Detener depuración, presione Mayúsculas+F5, o haga clic en el icono de la barra de herramientas de depuración, para detener la ejecución del código.
Quite los comentarios del código en los tres archivos cuyos nombres empiezan por Debug. A continuación, marque como comentario el código de los tres archivos cuyos nombres empiezan por NonDebug, o bien, seleccione dichos archivos en la ventana Explorador de soluciones, haga clic con el botón secundario del mouse y, después, haga clic en Excluir del proyecto.
En el menú Depurar, elija Inicio con el mismo punto de interrupción establecido. Cuando la aplicación se interrumpa, observe los detalles en la columna de valores de la ventana Variables locales, que ahora contiene información adicional proporcionada por los atributos de depuración.
Comentarios
El archivo DebugCustomer.cs contiene el atributo DebuggerDisplay siguiente para la clase CustomerName con el fin de proporcionar un ejemplo de cómo utilizar un atributo de depuración:
[DebuggerDisplay("{(FirstName == null) ? \"\":FirstName} {LastName} ==> (Customer ID = {Id})")]
Durante la depuración, este atributo muestra el valor siguiente en la ventana Variables locales. El nombre cn es una instancia de un objeto CustomerName.
Nombre |
Valor |
Type |
|---|---|---|
cn |
"Sally" "HighBridge" ==> (Id. de cliente = 12345) |
Microsoft.Samples.CustomerName |
Sin el atributo, en la ventana Variables locales se muestra lo siguiente:
Nombre |
Valor |
Type |
|---|---|---|
cn |
{Microsoft.Samples.CustomerName} |
Microsoft.Samples.CustomerName |