XamlParseException クラス

定義

名前空間:

System.Windows.Markup

アセンブリ:

PresentationFramework.dll

WPF XAML パーサーからのパーサー固有の例外の例外クラスを表します。 この例外は、.NET Framework 3.0 および .NET Framework 3.5 の XAML API または WPF XAML パーサー操作、または XamlReader API を呼び出して WPF XAML パーサーを特定するために使用されます。

C#

public class XamlParseException : SystemException

継承

Object

Exception

SystemException

XamlParseException

注釈

XamlParseException は、WPF アプリケーションの XAML 解析と読み込みを実行する WPF 実装 XAML パーサーにのみ使用されます。 具体的には、アプリケーションが .NET Framework 3.0 と .NET Framework 3.5 を対象とする場合にのみ、例外が関連します。 例外は、実行中の WPF アプリケーション内から XAML を読み込むための WPF 実装 XAML パーサーをフックする API の実行時呼び出し (たとえば、XamlReader.Loadの呼び出し) のユーザー コードから発生する場合もあります。

.NET Framework 4 の場合、通常、XAML 処理例外を報告する XamlParseException 例外は、別の名前空間 (System.Xaml) と別のアセンブリ (System.Xaml) で定義されます。

WPF XAML パーサーと同等のものを記述する場合や、.NET Framework 3.0 と .NET Framework 3.5 のターゲット設定を使用している場合を除き、通常は独自のコードから XamlParseException をスローしません。 ただし、例外の処理が必要な場合があります。 XAML 解析エラーを抑制するアプリケーション シナリオでは、アプリケーション レベルの DispatcherUnhandledException イベント ハンドラーは、実行時の XamlParseExceptionを処理する 1 つの方法です。 例外を抑制するか、ユーザー コードに表示させるかは、XAML を読み込む目的でアプリケーションを設計する方法と、アプリケーションが読み込む XAML に割り当てる信頼レベルによって異なります。 詳細については、XAML の概要 (WPF)の「XAML セキュリティに関する考慮事項」 または「XAML セキュリティ」セクション 参照してください。

アプリケーションのページの場合、XamlParseException がスローされると、通常は、ページ クラスによって行われた InitializeComponent 呼び出しのコンテキストで行われます。これは、WPF アプリケーション モデルがページ単位レベルで WPF XAML パーサーを使用するためのエントリ ポイントです。 したがって、別の可能な処理戦略は、try/catch ブロックを InitializeComponentに配置することです。 ただし、この手法は、テンプレート、ビジュアルデザインサーフェイス、および InitializeComponentをフックする他の生成されたソースとうまく統合されません。

コンストラクター

XamlParseException()	XamlParseException クラスの新しいインスタンスを初期化します。
XamlParseException(SerializationInfo, StreamingContext)	XamlParseException クラスの新しいインスタンスを初期化します。
XamlParseException(String)	指定した例外メッセージ文字列を使用して、XamlParseException クラスの新しいインスタンスを初期化します。
XamlParseException(String, Exception)	指定した例外メッセージ文字列と内部例外を使用して、XamlParseException クラスの新しいインスタンスを初期化します。
XamlParseException(String, Int32, Int32)	指定した例外メッセージ文字列と、指定した行番号と行内の位置を使用して、XamlParseException クラスの新しいインスタンスを初期化します。
XamlParseException(String, Int32, Int32, Exception)	指定した例外メッセージ、内部例外、行番号、および行内の位置を使用して、XamlParseException クラスの新しいインスタンスを初期化します。

プロパティ

BaseUri	例外がスローされたときにベース URI 情報を取得します。
Data	例外に関する追加のユーザー定義情報を提供するキーと値のペアのコレクションを取得します。 (継承元 Exception)
HelpLink	この例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。 (継承元 Exception)
HResult	特定の例外に割り当てられるコード化された数値である HRESULT を取得または設定します。 (継承元 Exception)
InnerException	現在の例外の原因となった Exception インスタンスを取得します。 (継承元 Exception)
KeyContext	例外が発生したディクショナリ内の項目のキー値を取得または設定します。
LineNumber	例外が発生した行番号を取得します。
LinePosition	例外が発生した行内の位置を取得します。
Message	現在の例外を説明するメッセージを取得します。 (継承元 Exception)
NameContext	例外が発生したオブジェクトの XAML 名を取得または設定します。
Source	エラーの原因となるアプリケーションまたはオブジェクトの名前を取得または設定します。 (継承元 Exception)
StackTrace	呼び出し履歴のイミディエイト フレームの文字列表現を取得します。 (継承元 Exception)
TargetSite	現在の例外をスローするメソッドを取得します。 (継承元 Exception)
UidContext	例外が発生したオブジェクトの x:Uid ディレクティブ を取得または設定します。

メソッド

Equals(Object)	指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetBaseException()	派生クラスでオーバーライドされた場合、1 つ以上の後続の例外の根本原因である Exception を返します。 (継承元 Exception)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetObjectData(SerializationInfo, StreamingContext)	指定した SerializationInfo オブジェクトにデータを入力して、指定したオブジェクトをシリアル化するために必要なデータを取得します。
GetType()	現在のインスタンスのランタイム型を取得します。 (継承元 Exception)
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
ToString()	現在の例外の文字列形式を作成して返します。 (継承元 Exception)

イベント

SerializeObjectState

例外に関するシリアル化されたデータを含む例外状態オブジェクトを作成するために例外がシリアル化されるときに発生します。 (継承元 Exception)

適用対象

こちらもご覧ください

• XAML サービス の