Пошаговое руководство. Отладка приложения WPF

Статья
08/11/2011

В данном пошаговом руководстве показано, как отладить простое приложение WPF с помощью конструктора сред. Конструктор WPF. Будет использоваться диалоговое окно Помощник по исправлению ошибок для интерпретации исключений синтаксического анализа XAML.

В данном пошаговом руководстве выполняются следующие задачи.

Создание проекта WPF.
Интерпретация исключения.
Интерпретация исключения, создаваемого дочерним элементом управления.

В результате будет полностью описан процесс интерпретации исключений, происходящих во время синтаксического анализа XAML.

Примечание

Отображаемые диалоговые окна и команды меню могут отличаться от описанных в справке в зависимости от текущих настроек или выпуска.Чтобы изменить параметры, выберите в меню Сервис пункт Импорт и экспорт параметров.Дополнительные сведения см. в разделе Работа с параметрами.

Обязательные компоненты

Ниже приведены компоненты, необходимые для выполнения данного пошагового руководства.

Visual Studio 2010.

Создание проекта

Первым этапом является создание проекта для приложения.

Создание проекта

Создайте новый проект приложения WPF на языке Visual Basic или Visual C# с именем DebuggingExample. Дополнительные сведения см. в разделе Практическое руководство. Создание нового проекта приложения WPF.

Файл MainWindow.xaml будет открыт в сред. Конструктор WPF.

В представлении XAML установите для свойства Background окна значение "Azure".

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

    </Grid>
</Window>

Цвет фона для окна обновляется в представлении конструктора.

Измените "Azure" на "Azurer" и щелкните в представлении конструктора.

Конструктор выведет сообщение "В документе имеются ошибки, которые должны быть исправлены перед обновлением конструктора. Чтобы открыть список ошибок, щелкните здесь".

В окне Список ошибок также отображается сообщение об ошибке "Недопустимый маркер".
В меню Отладка выберите команду Начать отладку.

Запускается приложение, открывается представление XAML и появляется диалоговое окно Помощник по исправлению ошибок, как показано на следующем рисунке.

Примечание. Если представление XAML не открывается при отображении помощника по исправлению ошибок, отключите параметр отладки Только мой код. Дополнительные сведения см. в разделе Практическое руководство. Переход в пошаговый режим выполнения "Только мой код".

Интерпретация исключения

Исключение — это ошибка синтаксического анализа XAML. В диалоговом окне Помощник по исправлению ошибок отображаются сведения об ошибке, которые можно использовать для интерпретации ее причины.

Интерпретация исключения

В диалоговом окне Помощник по исправлению ошибок щелкните ссылку Просмотр сведений...

Откроется диалоговое окно Просмотр сведений.
В разделе Снимок исключения разверните элемент System.Windows.Markup.XamlParseException.

Для элемента LineNumber отображается значение 3, а для элемента LinePosition — значение 5.
Щелкните элемент Message.
В конце строки появится кнопка со стрелкой вниз. Нажмите эту кнопку, чтобы увидеть все сообщение об ошибке, как показано на следующем рисунке.

Сообщение содержит текст: "Не удается преобразовать значение в атрибуте "Background" в объект типа "System.Windows.Media.Brush". Недопустимый маркер. Ошибка в объекте "DebuggingExample.MainWindow" из файла разметки "DebuggingExample;Component/MainWindow.xaml", строка 3, позиция 5".
Это исключение описывает ошибку синтаксического анализа XAML, произошедшую в файле MainWindow.xaml в строке 5.

Исключение вызвано по той причине, что конвертеру TypeConverter для объекта Brush не удалось преобразовать строку "Azurer" в объект Brush.
Нажмите кнопку OK, чтобы закрыть диалоговое окно Просмотр сведений.
Нажмите кнопку OK, чтобы закрыть диалоговое окно Помощник по исправлению ошибок.
В меню Отладка выберите Остановить отладку.

Создание проекта "UserControl"

Диалоговое окно Помощник по исправлению ошибок можно использовать для интерпретации ошибок, которые создаются элементом управления в отдельной сборке.

Создание проекта

В представлении XAML снова установите для свойства Background значение "Azure".
Добавьте новый проект библиотеки пользовательских элементов управления WPF с именем DemoControlLibrary в решение. Дополнительные сведения см. в разделе Практическое руководство. Создание проекта библиотеки элементов UserControl в WPF.

В конструкторе сред. Конструктор WPF откроется файл UserControl1.XAML.

В представлении XAML установите для свойства окна Background значение "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>

Выполните построение решения.
В обозревателе решений в проекте "DebuggingExample" добавьте ссылку на проект "DemoControlLibrary".
Откройте файл MainWindow.xaml в сред. Конструктор WPF.
Сопоставьте пространство имен "DemoControlLibrary", вставив следующий код XAML в открывающий тег <Window>. Дополнительные сведения см. в разделе Практическое руководство. Импорт пространства имен в XAML.
```
xmlns:d="clr-namespace:DemoControlLibrary;assembly=DemoControlLibrary"
```
Вставьте следующий код XAML после открывающего тега <Grid>.
```
<d:UserControl1 />
```
Представление конструктора обновится — изменится цвет фона.
Откройте файл UserControl1.xaml в конструкторе сред. Конструктор WPF.
В представлении XAML измените значение "Plum" на "Plumr".
В меню Отладка выберите команду Начать отладку.

Запускается приложение, открывается представление XAML для файла UserControl1.xaml и отображается диалоговое окно Помощник по исправлению ошибок.

Примечание. Если представление XAML не открывается при отображении помощника по исправлению ошибок, отключите параметр отладки Только мой код. Дополнительные сведения см. в разделе Практическое руководство. Переход в пошаговый режим выполнения "Только мой код".

Следующие действия

Также для просмотра ошибок синтаксического анализа XAML во время разработки можно использовать окно Список ошибок. Дополнительные сведения см. в разделе Ошибки XAML и справка.