Instruções passo a passo: depurando um formulário Web

Artigo
06/10/2015

As etapas deste passo a passo mostram como depurar um aplicativo Web do ASP.NET, também conhecido como um Web Form. Mostra como iniciar e interromper a execução, definir pontos de interrupção e examinar variáveis na janela Inspeção.

Dica

Para concluir este passo a passo, você deverá ter privilégios de administrador no computador do servidor.Por padrão, o processo do ASP.NET, aspnet_wp.exe ou w3wp.exe, é executado como um processo do ASP.NET.Para depurar o ASP.NET, você deverá ter privilégios de Administrador no computador no qual o ASP.NET é executado.Para obter mais informações, consulte Depuração do ASP.NET: requisitos do sistema.

As caixas de diálogo e os comandos do menu que você vê podem ser diferentes dos descritos na Ajuda, dependendo da edição ou das configurações ativas. Para alterar as configurações, escolha Importar e Exportar Configurações no menu Ferramentas. Para obter mais informações, consulte Personalizando configurações de desenvolvimento no Visual Studio.

Para criar o Web Form

Se você já tiver uma solução aberta, feche-a.
No menu Arquivo, clique em Novo e, em seguida, clique em Site.

A caixa de diálogo Novo Site aparece.
No painel Modelos, clique no Site ASP.NET.
Na linha Localização, clique em HTTP na lista e, na caixa de texto, digite https://localhost/WebSite.
Na lista Linguagem, clique em Visual C# ou Visual Basic.
Clique em OK.

O Visual Studio cria um novo projeto e exibe o código-fonte HTML padrão. Ele também cria um novo diretório virtual chamado Site em Site Padrão no IIS.
Clique na guia Design na margem inferior.
Clique na guia Caixa de Ferramentas na margem esquerda ou selecione-a no menu Exibir.

A Caixa de Ferramentas é aberta.
Na Caixa de Ferramentas, clique no controle Botão e adicione-o à superfície de design principal, Default.aspx.
Na Caixa de Ferramentas, clique no controle Caixa de Texto e arraste o controle para a superfície de design principal, Default.aspx.
Clique duas vezes no controle de botão que você removeu.

Isso leva à página de código: Default.aspx.cs para C# ou Default.aspx.vb para Visual Basic. O cursor deve estar na função Button1_Click.

Na função Button1_Click, adicione o seguinte código:

' Visual Basic
TextBox1.Text = "Button was clicked!"

// C#
TextBox1.Text = "Button was clicked!";

No menu Compilar, clique em Compilar Solução.

O projeto deve ser compilado sem erros.

Agora, você está pronto para iniciar a depuração.

Para depurar o Web Form

Na janelafault.aspx.cs ou Default.aspx.vb, clique na margem esquerda na mesma linha que o texto que você adicionou:
```
' Visual Basic
TextBox1.Text = "Button was clicked!"

// C#
textBox1.Text = "Button was clicked!";
```
Um ponto vermelho aparece e o texto da linha é realçado em vermelho. O ponto vermelho representa um ponto de interrupção. Quando você executa o aplicativo no depurador, o depurador interromperá a execução nesse local quando o código é atingido. Você pode exibir o estado do aplicativo e depurá-lo. Para obter mais informações, consulte Pontos de interrupção.
No menu Depuração, clique em Iniciar Depuração.
A caixa de diálogo Depuração Não Habilitada é exibida. Selecione a opção Modificar o arquivo Web.config para habilitar depuração e clique em OK.

O Internet Explorer inicia e exibe a página recém-criada.
No Internet Explorer, clique no botão.

No Visual Studio, essa opção leva você à linha onde você define o ponto de interrupção na página de código Default.aspx.cs ou Default.aspx.vb. Essa linha deve ser realçada em amarelo. Agora você pode exibir as variáveis em seu aplicativo e controlar sua execução. Seu aplicativo para a execução e aguarda você enviar um comando.
No menu Depurar, clique em Janelas e, em seguida, clique em Inspeção e em Watch1.
Na janela Inspeção, digite TextBox1.Text.

A janela Inspeção mostra o valor da variável TextBox1.Text:
```
""
```
No menu Depurar, clique em Depuração Parcial.

O valor de TextBox1.Text é alterado na janela Inspeção para ler:
```
"Button was clicked!"
```
No menu Depurar, clique em Continuar.
No Internet Explorer, clique no botão novamente.

A execução para no ponto de interrupção novamente.
Na janelafault.aspx.cs ou Default.aspx.vb, clique no ponto vermelho na margem esquerda:

Isso remove o ponto de interrupção.
No menu Depurar, clique em Parar Depuração.

Para anexar ao Web Form para depurar

No Visual Studio, você pode anexar o depurador a um processo em execução. Para obter uma depuração mais efetiva, compile o executável como arquivos da versão de depuração com símbolo (PDB).
Na janelafault.aspx.cs ou Default.aspx.vb, clique na margem esquerda para novamente definir um ponto de interrupção na linha adicionada:
```
' Visual Basic
TextBox1.Text = "Button was clicked!"

// C#
textBox1.Text = "Button was clicked!";
```
No menu Depurar, clique em Iniciar sem Depurar.

O Web Form começa a ser executado no Internet Explorer, mas o depurador não está anexado.
Anexe ao processo ASP.NET. Para obter mais informações, consulte Depurando aplicativos Web implantados.
No Internet Explorer, clique no botão no seu formulário.

No Visual Studio, você deve atingir o ponto de interrupção em Default.aspx.cs, Default.aspx.vb ou Default.aspx.
Quando você terminar de depurar, no menu Depurar, clique em Parar Depuração.

Consulte também

Outros recursos

Depurando aplicativos ASP.NET e AJAX

Partilhar via