XamlParseException 類別

定義

命名空間:

System.Windows.Markup

組件:

PresentationFramework.dll

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

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，XamlParseException通常會報告 XAML 處理例外狀況的例外狀況定義在不同的命名空間中， () 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 剖析器的進入點。 因此，另一個可能的處理策略是在 中InitializeComponent放置try/catch區塊。 不過，這項技術無法與範本、可視化設計介面和其他已產生的來源整合。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 服務