XamlParseException 類別

定義

命名空間:

System.Windows.Markup

組件:

PresentationFramework.dll

表示 WPF XAML 剖析器中剖析器特定例外狀況的例外狀況類別。 這個例外狀況用於來自 .NET Framework 3.0 和 .NET Framework 3.5 的 XAML API 或 WPF XAML 剖析器作業，或藉由呼叫 XamlReader API 來特定使用 WPF XAML 剖析器。

public ref class XamlParseException : SystemException

public class XamlParseException : SystemException

type XamlParseException = class
    inherit SystemException

Public Class XamlParseException
Inherits SystemException

繼承

Object

Exception

SystemException

XamlParseException

備註

XamlParseException 僅適用於執行 WPF 應用程式 XAML 剖析和載入的 WPF 實作 XAML 剖析器。 具體而言，只有在應用程式以 .NET Framework 3.0 和 .NET Framework 3.5 為目標時，例外狀況才相關。 例外狀況也可能來自運行時間呼叫 API 中的使用者程式代碼，這些 API 會連結 WPF 實作的 XAML 剖析器，以從執行中的 WPF 應用程式載入 XAML（例如，呼叫 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的一種方式。 是否要隱藏例外狀況或讓他們呈現給使用者程式代碼，取決於您設計應用程式以載入 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()	在衍生類別中覆寫時，傳回 Exception，這是一或多個後續例外狀況的根本原因。 (繼承來源 Exception)
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetObjectData(SerializationInfo, StreamingContext)	藉由填入指定的 SerializationInfo 物件，取得串行化指定物件所需的數據。
GetType()	取得目前實例的運行時間類型。 (繼承來源 Exception)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
ToString()	建立並傳回目前例外狀況的字串表示。 (繼承來源 Exception)

事件

SerializeObjectState

發生於例外狀況串行化以建立例外狀況狀態物件，其中包含例外狀況的串行化數據。 (繼承來源 Exception)

另請參閱

• XAML 服務