Tutorial: Depurar una aplicación de WPF

Actualización: noviembre 2007

En este tutorial se muestra cómo depurar una aplicación de Windows Presentation Foundation (WPF) simple con WPF Designer. Se utilizará el cuadro de diálogo Asistente de excepciones para interpretar una excepción de análisis de XAML (Lenguaje de marcado de aplicaciones extensible).

En este tutorial realizará las siguientes tareas:

Crear un proyecto de WPF.
Interpretar una excepción.
Interpretar una excepción de un control secundario.

Cuando haya finalizado, sabrá cómo interpretar las excepciones que se producen durante el análisis del XAML.

Nota:
Los cuadros de diálogo y comandos de menú que se ven pueden diferir de los descritos en la Ayuda, dependiendo de los valores de configuración o de edición activos. Para cambiar la configuración, elija Importar y exportar configuraciones en el menú Herramientas. Para obtener más información, vea Valores de configuración de Visual Studio.

Requisitos previos

Necesita los componentes siguientes para completar este tutorial:

Visual Studio 2008.

Creación del proyecto

El primer paso consiste en crear el proyecto para la aplicación.

Para crear el proyecto

Cree un nuevo proyecto de aplicación WPF en Visual Basic o en Visual C# denominado DebuggingExample. Para obtener más información, vea Cómo: Crear un nuevo proyecto de aplicación de WPF.

Window1.xaml se abrirá en el WPF Designer.

En la vista de XAML, establezca la propiedad Background de la ventana en "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>

El color de fondo de la ventana se actualiza en la vista Diseño.

Cambie "Azure" por "Azurer" y haga clic en la vista Diseño.

La vista Diseño muestra el mensaje "El documento contiene errores que se deben corregir para poder actualizar el diseñador. Haga clic aquí para abrir la lista de errores."

Asimismo, la ventana Lista de errores muestra el mensaje de error "El símbolo (token) no es válido".
En el menú Depurar, elija Iniciar depuración.

La aplicación se inicia, se abre la vista XAML y aparece el cuadro de diálogo Asistentes de excepciones, como se muestra en la ilustración siguiente.

Nota: si la vista XAML no se abre cuando aparece el Asistente de excepciones, desactive la opción de depuración Sólo mi código. Para obtener más información, vea Cómo: Avanzar en Sólo mi código.

Interpretar la excepción

La excepción es un error de análisis de XAML. El cuadro de diálogo Asistente de excepciones muestra información sobre el error que puede utilizar para interpretar la causa.

Para interpretar la excepción

En el cuadro de diálogo Asistente de excepciones, haga clic en el vínculo Ver detalle.

Se abre el cuadro de diálogo Ver detalle.
En la sección Instantánea de la excepción, expanda el elemento System.Windows.Markup.XamlParseException.

El elemento LineNumber muestra 3 y el elemento LinePosition muestra 5.
Haga clic en el elemento Message.
Un botón de flecha abajo aparece al final de la línea. Haga clic en el botón de flecha abajo para ver el mensaje de error completo, como se muestra en la ilustración siguiente.

El mensaje dice así: "No se puede convertir el valor del atributo 'Background' en un objeto de tipo 'System.Windows.Media.Brush'. El símbolo (token) no es válido. Error en el objeto 'DebuggingExample.Window1' en el archivo de marcado 'DebuggingExample;component/window1.xaml' Línea 3 Posición 5."
Esta excepción describe un error de análisis de XAML que se ha producido en la línea cinco del archivo Window1.xaml.

Se produce la excepción porque el convertidor de tipos (TypeConverter) del objeto Brush no pudo convertir la cadena "Azurer" en un objeto Brush.
Haga clic en Aceptar para cerrar el cuadro de diálogo Ver detalle.
Haga clic en Aceptar para cerrar el cuadro de diálogo Asistente de excepciones.
En el menú Depurar, seleccione Detener depuración.

Crear el proyecto UserControl

Puede utilizar el cuadro de diálogo Asistente de excepciones para interpretar errores que se inician en un control de un ensamblado independiente.

Para crear el proyecto

En la vista XAML, cambie el valor de la propiedad Background por "Azure".
Agregue un nuevo proyecto de biblioteca de controles de usuario de WPF denominado DemoControlLibrary a la solución. Para obtener más información, vea Cómo: Crear un proyecto de biblioteca de controles de usuario de WPF.

Se abre UserControl1.xaml en WPF Designer.

En la vista XAML, establezca la propiedad Background de la ventana en "Plum".

<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>

Genere la solución.
En el proyecto DebuggingExample del Explorador de soluciones, agregue una referencia al proyecto DemoControlLibrary.
Abra Window1.xaml en WPF Designer.
Asigne el espacio de nombres DemoControlLibrary insertando el XAML siguiente en la etiqueta de apertura <Window>. Para obtener más información, vea Cómo: Importar un espacio de nombres a XAML.
```
xmlns:d="clr-namespace:DemoControlLibrary;assembly=DemoControlLibrary"
```
Inserte el XAML siguiente después de la etiqueta de apertura <Grid>.
```
<d:UserControl1 />
```
La vista Diseño se actualiza con el nuevo color de fondo.
Abra UserControl1.xaml en WPF Designer.
En la vista XAML, cambie "Plum" por "Plumr".
En el menú Depurar, elija Iniciar depuración.

La aplicación se inicia, se abre la vista XAML con UserControl1.xaml y aparece el cuadro de diálogo Asistente de excepciones.

Nota: si la vista XAML no se abre cuando aparece el Asistente de excepciones, desactive la opción de depuración Sólo mi código. Para obtener más información, vea Cómo: Avanzar en Sólo mi código.

Pasos siguientes

También puede utilizar la ventana Lista de errores para ver los errores de análisis de XAML en tiempo de diseño. Para obtener más información, vea Errores de XAML y Ayuda.