Demonstra Passo a passo: Depurando um aplicativo do WPF

Artigo
08/25/2010

Essa explicação passo a passo mostra como depurar um aplicativo simples com o WPF Designer Windows Presentation Foundation (WPF).Você usará o Exception Assistant caixa de diálogo para interpretar um Extensible Application Markup Language (XAML) analisar exceção.

Nesta explicação passo a passo, você executa as seguintes tarefas:

Crie um projeto.
Interpretar uma exceção.
Interpretar uma exceção de uma controle filho.

Quando você terminar, você saberá como interpretar exceções que ocorrem durante a análise XAML.

Observação:
As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritas na Ajuda, dependendo das configurações ativas ou configurações de edição.Para alterar as configurações, escolher Importar e exportar configurações on the Ferramentas menu.Para obter mais informações, consulte Configurações do Visual Studio.

Pré-requisitos

Para completar este passo a passo, são necessários os seguintes componentes:

Visual Studio 2008.

Criando o projeto

A primeira etapa é criar um projeto para a aplicação.

Para criar o projeto

Criar um novo projeto de aplicativo WPF em Visual Basic ou Visual C# chamado DebuggingExample .Para obter mais informações, consulte Como: Criar um novo projeto de aplicativo do WPF.

Window1.xaml é aberto no WPF Designer.

No modo de exibição XAML, conjunto Backgroundpropriedade para "Azure".

<Window x:Class="DebuggingExample.Window1"
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
    Background="Azure"
    Title="Window1" Height="300" Width="300">
    <Grid>

    </Grid>
</Window>

O cor do plano de fundo para obter as atualizações no design janela Exibir.

Altere "Azure "para" Azurer" e clique no modo de exibição de design.

O Modo Design exibe a mensagem "o documento contém erros que devem ser corrigidos antes o criador pode ser atualizado.Clique aqui para abrir a Lista de erros. "

Além disso, o Lista de erros janela exibe o mensagem de erro "token não é válido".
No menu Debug, selecione Start Without Debugging.

O aplicativo for iniciado, abre o modo de exibição XAML e Exception Assistant caixa de diálogo aparece, como mostrado na ilustração a seguir.

Observação Se a exibição XAML não abre quando aparecer a Exception Assistant, desative a Just My Code Depuração opção.Para obter mais informações, consulte Como: Etapa em Just My Code.

Interpretando a exceção

A exceção é um erro de análise XAML. Exception Assistant caixa de diálogo mostra informações sobre o erro, que você pode usar para interpretar sua causa.

Para interpretar a exceção

Na caixa Exception Assistant caixa de diálogo, clique em Exibir Detail… Vincular.

O modo de exibição detalhe Abre caixa de diálogo.
Na caixa Exceção instantâneo Seção, expanda o item System.Windows.Markup.XamlParseException.

Exibe o item LineNumber3 e LinePosition item exibe 5 .
Clique no item Message.
Um botão de seta para baixo aparece no participante da linha.clicar no botão de seta para baixo para ver a mensagem de erro inteira, sistema autônomo mostrado na ilustração a seguir.

Lê a mensagem "Não é possível converter o valor no atributo 'Plano de fundo' ao objeto do tipo 'System.Windows.Media.Brush'.Token não é válido.Erro no objeto 'DebuggingExample.Window1' no arquivo de marcação 'DebuggingExample;Component/window1.xaml' linha 3 posição 5. "
Essa exceção é que descreve um erro de análise XAML encontrado no arquivo Window1.XAML, na linha 5.

A exceção é gerada porque o TypeConverter para Brush Não foi possível converter a sequência "Azurer" em um objeto Brush.
Clique em OK para fechar o modo de exibição de detalhes caixa de diálogo.
Clique para fechar a OK Exception Assistant caixa de diálogo.
A partir do Menu Debug, escolha Stop Debugging.

Criando o projeto UserControl

Você pode usar a Exception Assistant caixa de diálogo para interpretar erros que são gerados a partir de um controle em um conjunto separado.

Para criar o projeto

No modo de exibição XAML, altere o valor da propriedade Background voltar para "Azure".
Adicione um novo projeto Biblioteca de controle de usuário WPF chamado DemoControlLibrary à solução DemoApplication.Para obter mais informações, consulte Como: Criar um projeto de biblioteca do UserControl WPF.

UserControl1.XAML é aberto no WPF Designer.

No modo de exibição XAML, conjunto Backgroundpropriedade para "Ameixa".

<UserControl x:Class="DemoControlLibrary1.UserControl1"
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
    Background="Plum"
    Height="300" Width="300">
    <Grid>

    </Grid>
</UserControl>

Crie a solução.
Em Gerenciador de Soluções , no projeto DebuggingExample, adicione uma referência ao projeto DemoControlLibrary.
Abra Window1.xaml no WPF Designer.
Mapear o namespace DemoControlLibrary inserindo o XAML a seguir para a <Window> marca de abertura.Para obter mais informações, consulte Como: Importar um Namespace em XAML.
```
xmlns:d="clr-namespace:DemoControlLibrary;assembly=DemoControlLibrary"
```
Insira o seguinte XAML após a <Grid> marca de abertura.
```
<d:UserControl1 />
```
Crie modo de exibição atualizações com o novo cor do plano de fundo.
Abra UserControl1.xaml no WPF Designer.
No modo de exibição XAML, alterar "Plum" para "Plumr".
No menu Debug, selecione Start Without Debugging.

O aplicativo for iniciado, o XAML o modo de exibição é aberto para UserControl1.XAML e a Exception Assistant caixa de diálogo aparece.

Observação Se a exibição XAML não abre quando aparecer a Exception Assistant, desative a Just My Code Depuração opção.Para obter mais informações, consulte Como: Etapa em Just My Code.

Próximas etapas

Você também pode usar a Lista de erros janela para exibir XAML análise erros no tempo de design.Para obter mais informações, consulte XAML Erros e Ajuda.