Tutorial: Depurar un formulario Windows Forms

Este tema se aplica a:

Edición	Visual Basic	C#	C++	Web Developer
Express			Sólo administrado
Pro, Premium y Ultimate			Sólo administrado

Un formulario Windows Forms es una de las aplicaciones administradas más comunes. Con los formularios Windows Forms se crean aplicaciones estándar de Windows. Puede completar este tutorial utilizando Visual Basic, C# o C++.

En primer lugar, debe cerrar las soluciones que estén abiertas.

Pasos preliminares de este tutorial

• Si tiene una solución abierta, ciérrela. (En el menú Archivo, seleccione Cerrar solución.)

Crear un nuevo formulario Windows Forms

A continuación, creará un nuevo formulario Windows Forms.

Para crear el formulario Windows Forms para este tutorial

1. En el menú Archivo, elija Nuevo y, a continuación, haga clic en Proyecto.

   Aparecerá el cuadro de diálogo Nuevo proyecto.

2. En el recuadro Tipos de proyecto, abra el nodo Visual Basic, Visual C# o Visual C++ y, a continuación,

   1. En Visual Basic o Visual C#, seleccione el nodo Windows y, a continuación, Aplicación de Windows Forms en el panel Plantillas.

   2. En Visual C++, seleccione el nodo CLR y, a continuación, Aplicación de Windows Forms en el panel Plantillas.

3. En el panel Plantillas, seleccione Aplicación para Windows.

4. En el cuadro Nombre, asigne un nombre único al proyecto (por ejemplo, Walkthrough_SimpleDebug).

5. Haga clic en Aceptar.

   Visual Studio crea un proyecto nuevo y muestra un formulario nuevo en el Diseñador de Windows Forms. Para obtener más información, vea Diseñador de Windows Forms.

6. En el menú Ver, seleccione Cuadro de herramientas.

   Se abrirá el Cuadro de herramientas. Para obtener más información, vea Cuadro de herramientas.

7. En el Cuadro de herramientas, haga clic en el control Button y arrástrelo a la superficie de diseño del formulario. Coloque el botón en el formulario.

8. En el Cuadro de herramientas, haga clic en el control TextBox y arrástrelo a la superficie de diseño del formulario. Coloque el control TextBox en el formulario.

9. En la superficie de diseño del formulario, haga doble clic en el botón.

   Esto le lleva a la página de código. El cursor debe estar en button1_Click.

10. Agregue el código siguiente a la función button1_Click:

    ' Visual Basic
    textBox1.Text = "Button was clicked!"
    
    // C#
    textBox1.Text = "Button was clicked!";
    
    // C++
    textBox1->Text = "Button was clicked!";
    

11. En el menú Generar, seleccione Generar solución.

    El proyecto se debe generar sin errores.

Depurar el formulario

Ahora está listo para comenzar la depuración.

Para depurar el formulario Windows Forms creado para este tutorial

1. En la ventana de código fuente, haga clic en el margen izquierdo en la misma línea que el texto que agregó:

   ' Visual Basic
   textBox1.Text = "Button was clicked!"
   
   // C#
   textBox1.Text = "Button was clicked!";
   
   // C++
   textBox1->Text = "Button was clicked!";
   

   Aparecerá un punto rojo y el texto de la línea se resaltará en rojo. El punto rojo representa un punto de interrupción. Para obtener más información, vea Puntos de interrupción. Cuando ejecute la aplicación en el depurador, éste interrumpirá la ejecución del código en la posición donde encuentre un punto de interrupción. Esto le permite ver el estado de la aplicación y depurarla.

   Nota

   También puede hacer clic con el botón secundario en cualquier línea de código, seleccionar Punto de interrupción y, a continuación, hacer clic en Insertar punto de interrupción para agregar un punto de interrupción en esa línea.

2. En el menú Depurar, elijaIniciar.

   El formulario Windows Forms comienza su ejecución.

3. En el formulario Windows Forms, haga clic en el botón agregado.

   En Visual Studio, esto le lleva a la línea en la que estableció el punto de interrupción en la página de código. Esta línea debe aparecer resaltada en amarillo. Ahora puede ver las variables de la aplicación y controlar su ejecución. La aplicación ha detenido ahora su ejecución y espera a que se le indique una acción.

4. En el menú Depurar, elija Ventanas, después Inspección y, a continuación, haga clic en Inspección1.

5. En la ventana Inspección1, haga clic en una fila en blanco. En la columna Nombre, escriba textBox1.Text (si utiliza Visual Basic, Visual C# o J#) o textBox1->Text (si utiliza C++), luego presione ENTRAR.

   En la ventana Inspección1 se muestra el valor de esta variable entre comillas:

   ""
   

6. En el menú Depurar, elija Paso a paso por instrucciones.

   El valor de textBox1.Text cambia en la ventana Inspección1a:

   Button was clicked!
   

7. En el menú Depurar, elija Continuar para reanudar la depuración del programa.

8. En el formulario Windows Forms, haga clic de nuevo en el botón.

   Visual Studio vuelve a interrumpir la ejecución.

9. Haga clic en el punto rojo que representa al punto de interrupción.

   Esto quita el punto de interrupción del código.

10. En el menú Depurar, elija Detener depuración.

Adjuntar la aplicación de formularios Windows Forms para la depuración

En Visual Studio, puede adjuntar el depurador a un proceso en ejecución. Si utiliza Express Edition, esta característica no es compatible.

Para adjuntar la aplicación de formularios Windows Forms para la depuración

1. En el proyecto creado anteriormente, haga clic en el margen izquierdo para volver a establecer un punto de interrupción en la línea agregada:

   ' Visual Basic
   textBox1.Text = "Button was clicked!"
   
   // C#
   textBox1.Text = "Button was clicked!"
   
   // C++
   textBox1->Text = "Button was clicked!";
   

2. En el menú Depurar, seleccione Iniciar sin depurar.

   El formulario Windows Forms comenzará su ejecución en Windows, como si se hubiera hecho doble clic en su archivo ejecutable. El depurador no se ha asociado.

3. En el menú Depurar, seleccione Asociar al proceso. (Este comando también está disponible en el menú Herramientas).

   Aparecerá el cuadro de diálogo Asociar al proceso.

4. En el panel Procesos disponibles, busque el nombre del proceso (Walkthrough_SimpleDebug.exe) en la columna Proceso y haga clic en él.

5. Haga clic en el botón Asociar.

6. En el formulario Windows Forms, haga clic en el único botón.

   El depurador interrumpe la ejecución del formulario Windows Forms en el punto de interrupción.

Vea también

Conceptos

Seguridad del depurador

Otros recursos

Depurar código administrado

Historial de cambios