Asignar dependencias específicas en mapas de código

Cuando desee comprender dependencias concretas dentro del código, visualícelas creando mapas de código (solo en Visual Studio Ultimate). Podrá navegar entre estas relaciones utilizando el mapa que aparece junto a su código. Esto le ayudará a realizar un seguimiento del lugar en que se encuentra en el código mientras trabaja.

Una flecha verde muestra la posición del cursor en el editor. Puede tomar notas en un mapa, como en papel.

Los mapas de código impiden perderse en bases de código de gran tamaño, código con el que no esté familiarizado o código heredado. Por ejemplo, en la depuración, es posible que tenga que buscar en varios proyectos y archivos. Los mapas de código facilitan la navegación por estos fragmentos de código y permiten ver las relaciones entre ellos. No tiene que recordar todo este código, realizar un seguimiento de los archivos o dibujar un diagrama de papel independiente. Si tiene que interrumpir su trabajo, los mapas de código ayudan recordar el código en que está trabajando.

Crear o abrir un mapa de código

Para crear un mapa de código, necesita Visual Studio Ultimate 2013 y una solución con Visual C#. NET, Visual Basic. NET, X ++ para Microsoft Dynamics AX o código de C++ (compatibilidad limitada). Para obtener relaciones codificadas por colores, necesitará Visual Studio 2013 Update 3. Para asignar código de X++ y código compartido entre varias aplicaciones, necesitará Visual Studio 2013 Update 2 o una versión posterior.

También puede crear un mapa de código mediante lo siguiente:

• Haga clic con el botón derecho, por ejemplo, en un archivo de origen o uno binario en el Explorador de soluciones y seleccione Mostrar en mapa de código. Esto permite crear un mapa de código para el elemento seleccionado.

• Arrastre un elemento, por ejemplo, un archivo de origen o un archivo binario desde el Explorador de soluciones a un mapa de código abierto para incluir o resaltar el elemento en el mapa.

• Haga clic con el botón derecho en un área vacía de la ventana del editor y seleccione Mostrar en mapa de código. Esto permite crear un nuevo mapa de código vacío.

• Haga clic con el botón derecho en un objeto o en una clase en la ventana del editor y seleccione Mostrar en mapa de código. Esto permite crear un mapa de código para el elemento seleccionado. También puede buscar todas las referencias o mostrar elementos relacionados en un mapa de código con este menú.

• Haga clic en el botón Mapa de código situado en el menú Depurar cuando la aplicación esté en pausa.

• En un archivo de IntelliTrace abierto, o como un gráfico de dependencias del menú Arquitectura.

Puede ver, realizar modificaciones limitadas y navegar por los mapas de código mediante Visual Studio Premium 2013 o Visual Studio Professional 2013.

Antes de compartir mapas con otros usuarios que utilizan la versión Premium o Professional, asegúrese de que todos los elementos del mapa estén visibles, como, por ejemplo, los elementos ocultos, los grupos expandidos y los vínculos entre grupos.

Vea los mapas de código en acción: Descripción de código complejo con mapas de código (Channel 9)

Entender el problema

Supongamos que hay un error en un programa de dibujo en el que está trabajando. Para reproducir el error, abra la solución en Visual Studio Ultimate y presione F5 para iniciar la depuración.

Cuando dibuje una línea y elija Deshacer mi último trazo, no sucederá nada hasta que se dibuje la línea siguiente.

Por tanto, comienza la investigación buscando el método Undo. Lo encuentra en la clase PaintCanvas.

Empezar a asignar el código

Ahora comienza la asignación del método undo y sus relaciones. Desde el editor de código, agrega el método undo y los campos a los que se hace referencia a un nuevo mapa de código. Cuando se crea un nuevo mapa, es posible que se tarde algo de tiempo en indizar el código. Esto ayuda a que se ejecuten más rápido las operaciones posteriores.

Navegar y examinar código desde la asignación

Para consultar la definición de código de cada campo, haga doble clic en el campo del mapa o elija el campo y presione F12. La flecha verde se desplaza entre los elementos del mapa. El cursor del editor de código también se desplaza automáticamente.

Entender las relaciones entre los elementos de código

Ahora desea saber qué otro código interactúa con los campos history y paintObjects. Puede agregar todos los métodos que hacen referencia a estos campos al mapa. Puede hacer esto desde el mapa o desde el código.

Cambie el diseño para reorganizar el flujo de las relaciones y facilitar la lectura del mapa. También puede mover los elementos por el mapa arrastrándolos.

Examinemos estos métodos. En el mapa, haga doble clic en el método PaintCanvas o elija este método y presione F12. Verá que este método crea history y paintObjects como listas vacías.

Ahora repita los mismos pasos para examinar la definición del método clear. Verá que clear lleva a cabo algunas tareas con paintObjects e history. A continuación, llama al método Repaint.

Ahora, examine la definición del método addPaintObject. También realiza algunas tareas con history y paintObjects. También llama a Repaint.

Buscar el problema examinando la asignación

Parece que todos los métodos que modifican history y paintObjects llaman a Repaint. Con todo, el método undo no llama a Repaint, aunque undo modifica los mismos campos. Por tanto, cree que puede corregir este problema mediante una llamada a Repaint desde undo.

Si no tuviese un mapa para encontrar la llamada que falta, posiblemente sería más difícil localizar este problema, sobre todo con código más complejo.

Compartir la información y pasos siguientes

Antes de que usted u otro usuario corrija este error, puede hacer anotaciones en el mapa acerca del problema y de cómo corregirlo.

Por ejemplo, puede agregar comentarios al mapa y marcar los elementos con colores.

Si tiene Microsoft Outlook instalado, puede enviar el mapa a otras personas por correo electrónico. También puede exportar el mapa como imagen u otro formato.

Corregir el problema y mostrar lo que hizo

Para corregir este error, agregue la llamada de Repaint a undo.

Para confirmar la corrección, reinicie su sesión de depuración e intente reproducir el error. Ahora, si elige Deshacer mi último trazo funciona como se esperaba y confirma que su corrección ha sido la adecuada.

Puede actualizar el mapa para mostrar la corrección que realizó.

El mapa muestra ahora un vínculo entre deshacer y Volver a dibujar.

Ahora ha terminado con la investigación. Encontró y corrigió correctamente el problema asignando el código. También tiene un mapa que le ayuda a navegar por el código y a recordar lo que ha aprendido, y le muestra los pasos llevados a cabo para corregir el problema.

Vea también

Conceptos

Asignar métodos en la pila de llamadas durante la depuración en Visual Studio

Visualizar el código