Preparação da depuração: aplicativos dos Windows FormsDebugging Preparation: Windows Forms Applications

O modelo de projeto do Windows Forms (.NET) cria um aplicativo do Windows Forms.The Windows Forms project template creates a Windows Forms application. Depurar esse tipo de aplicativo no Visual StudioVisual Studio é simples.Debugging this type of application in Visual StudioVisual Studio is straightforward. Para obter mais informações, consulte criando um projeto de aplicativo do Windows.For more information, see Creating a Windows Application Project.

Quando você cria um projeto do Windows Forms com o modelo de projeto, o Visual StudioVisual Studio cria automaticamente as configurações necessárias para as configurações de depuração e versão.When you create a Windows Forms project with the project template, Visual StudioVisual Studio automatically creates required settings for the Debug and Release configurations. Se necessário, você pode alterar essas configurações.If necessary, you can change these settings. Essas configurações podem ser alteradas na caixa de diálogo <nome do projeto> Páginas de Propriedades (Meu Projeto em Visual Basic).These settings can be changed in the <project name> Property Pages dialog box (My Project in Visual Basic).

Para obter mais informações, consulte as configurações de propriedade recomendadas.For more information, see Recommended Property Settings.

A tabela a seguir exibe uma configuração de propriedade recomendada adicional.The following table displays one additional recommended property setting.

Propriedades de configuração na guia DepurarConfiguration Properties in Debug tab

Nome da propriedadeProperty Name ConfiguraçãoSetting
Iniciar açãoStart Action – Definido como Iniciar projeto, na maioria das vezes.- Set to Start project, most of the time. Definido como Iniciar programa externo se você quiser iniciar outro executável ao iniciar a depuração (geralmente para depuração de DLLs).Set to Start external program if you want to start another executable when you start debugging (usually for debugging DLLs).

Você pode depurar aplicativos do Windows Forms de dentro do Visual StudioVisual Studio ou anexando a um aplicativo já em execução.You can debug Windows Forms applications from inside Visual StudioVisual Studio, or by attaching to an already running application. Para obter mais informações sobre como anexar, consulte anexar a processos em execução.For more information about attaching, see Attach to Running Processes.

Para depurar um aplicativo C#, F# ou Windows Forms do Visual BasicTo debug a C#, F#, or Visual Basic Windows Forms application

  1. Abra o projeto no Visual StudioVisual Studio.Open the project in Visual StudioVisual Studio.

  2. Crie pontos de interrupção conforme o necessário.Create breakpoints as needed.

    Como os aplicativos do Windows Forms são controlados por eventos, seus pontos de interrupção entrarão no código do manipulador de eventos ou nos métodos chamados pelo código do manipulador de eventos.Because Windows Forms applications are event-driven, your breakpoints will go into event handler code, or into methods called by event handler code. Eventos comuns nos quais colocar pontos de interrupção incluem:Typical events in which to place breakpoints include:

    1. Os eventos associados a um controle, como Clique, Insira etc.Events associated with a control, such as Click, Enter, etc.

    2. Os eventos associados à inicialização e o desligamento do aplicativo, como Carregar, Ativado etc.Events associated with application startup and shutdown, such as Load, Activated, etc.

    3. Foco e eventos de validação.Focus and Validation Events.

      Para obter mais informações, consulte Criando manipuladores de eventos nos Windows Forms.For more information, see Creating Event Handlers in Windows Forms.

  3. No menu Depurar, clique em Iniciar.On the Debug menu, click Start.

  4. Depure usando as técnicas discutidas na primeira olhada no depurador.Debug using the techniques discussed in First look at the debugger.

Consulte tambémSee also