チュートリアル : WPF アプリケーションのデバッグ

2008-09-30

更新 : 2007 年 11 月

このチュートリアルでは、WPF デザイナでシンプルな WPF (Windows Presentation Foundation) アプリケーションをデバッグする方法を次のコード例に示します。XAML (Extensible Application Markup Language) 解析例外を解釈するには、[例外処理アシスタント] ダイアログボックスを使用します。

このチュートリアルでは次のタスクを行います。

WPF プロジェクトを作成する。
例外を解釈する。
子コントロールからの例外を解釈する。

このチュートリアルを終了すると、XAML 解析中に発生した例外を解釈する方法を理解できるようになります。

メモ :
使用している設定またはエディションによっては、ヘルプの記載と異なるダイアログボックスやメニューコマンドが表示される場合があります。設定を変更するには、[ツール] メニューの [設定のインポートとエクスポート] をクリックします。詳細については、「Visual Studio の設定」を参照してください。

使用している設定またはエディションによっては、ヘルプの記載と異なるダイアログボックスやメニューコマンドが表示される場合があります。設定を変更するには、[ツール] メニューの [設定のインポートとエクスポート] をクリックします。詳細については、「Visual Studio の設定」を参照してください。

前提条件

このチュートリアルを完了するには、次のコンポーネントが必要です。

Visual Studio 2008.

プロジェクトの作成

最初にアプリケーションのプロジェクトを作成します。

プロジェクトを作成するには

Visual Basic または Visual C# で DebuggingExample という名前の WPF アプリケーションプロジェクトを作成します。詳細については、「方法 : 新しい WPF アプリケーションプロジェクトを作成する」を参照してください。

WPF デザイナで Window1.xaml が開きます。

XAML ビューで、ウィンドウの Background プロパティを "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>

デザインビューでウィンドウの背景色が更新されます。

"Azure" を "Azurer" に変更して、デザインビュー内をクリックします。

デザインビューに、"デザイナを更新する前に修正しなければならないエラーがドキュメントに含まれています。エラー一覧を表示するには、ここをクリックしてください。" というメッセージが表示されます。

また、[エラー一覧] ウィンドウには "トークンが無効です。" というエラーメッセージが表示されます。
[デバッグ] メニューの [デバッグ開始] をクリックします。

アプリケーションが起動し、XAML ビューが開き、次の図に示す [例外処理アシスタント] ダイアログボックスが表示されます。

メモ [例外アシスタント] が表示されても XAML ビューが開かなかった場合は、[マイコードのみ] デバッグオプションをオフにしてください。詳細については、「方法 : マイコードのみにステップインする」を参照してください。

例外の解釈

この例外は XAML 解析エラーです。[例外アシスタント] ダイアログボックスには、エラー原因の解明に役立つエラー情報が示されます。

例外を解釈するには

[例外アシスタント] ダイアログボックスで、[詳細の表示] をクリックします。

[詳細の表示] ダイアログボックスが表示されます。
[例外のスナップショット] で [System.Windows.Markup.XamlParseException] 項目を展開します。

[LineNumber] 項目には "3" と表示され、[LinePosition] 項目には "5" と表示されます。
[メッセージ] 項目をクリックします。
行末に下向き矢印ボタンが表示されます。この下向き矢印ボタンをクリックして、次の図のように、エラーメッセージ全体を表示します。

"属性 'Background' の値を型 'System.Windows.Media.Brush' のオブジェクトに変換することはできません。トークンが無効です。マークアップファイル 'DebuggingExample;component/window1.xaml' 行 3 位置 5 のオブジェクト 'DebuggingExample.Window1' にエラーがあります。" というメッセージが表示されます。
この例外は、Window1.xaml ファイルの 5 行目で発生した XAML 解析エラーを示しています。

この例外は、Brush の TypeConverter が "Azurer" 文字列を Brush オブジェクトに変換できなかったことが原因で発生しました。
[OK] をクリックして [詳細の表示] ダイアログボックスを閉じます。
[OK] をクリックして [例外アシスタント] ダイアログボックスを閉じます。
[デバッグ] メニューの [デバッグの停止] をクリックします。

UserControl プロジェクトの作成

[例外アシスタント] ダイアログボックスを使用して、別のアセンブリにあるコントロールから発生したエラーを解釈することもできます。

プロジェクトを作成するには

XAML ビューで、Background プロパティの値を "Azure" に戻します。
ソリューションに DemoControlLibrary という名前の新しい WPF ユーザーコントロールライブラリプロジェクトを追加します。詳細については、「方法 : WPF UserControl ライブラリプロジェクトを作成する」を参照してください。

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 プロジェクトへの参照を追加します。
WPF デザイナで Window1.xaml を開きます。
次の XAML を <Window> 開始タグ内に挿入することにより、DemoControlLibrary 名前空間をマップします。詳細については、「方法 : 名前空間を XAML にインポートする」を参照してください。
```
xmlns:d="clr-namespace:DemoControlLibrary;assembly=DemoControlLibrary"
```
<Grid> 開始タグの後に、次の XAML を挿入します。
```
<d:UserControl1 />
```
新しい背景色でデザインビューが更新されます。
WPF デザイナで UserControl1.xaml を開きます。
XAML ビューで "Plum" を "Plumr" に変更します。
[デバッグ] メニューの [デバッグ開始] をクリックします。

アプリケーションが起動し、XAML ビューが開いて UserControl1.xaml が表示され、[例外処理アシスタント] ダイアログボックスが表示されます。

メモ [例外アシスタント] が表示されても XAML ビューが開かなかった場合は、[マイコードのみ] デバッグオプションをオフにしてください。詳細については、「方法 : マイコードのみにステップインする」を参照してください。