XamlParseException 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
表示來自 WPF XAML 剖析器之剖析器特有例外狀況的例外狀況類別。 這個例外狀況用於 .NET Framework 3.0 和 .NET Framework 3.5 中的 XAML API 或 WPF XAML 剖析器作業,或特別供 WPF XAML 剖析器在呼叫 XamlReader API 時使用。
public ref class XamlParseException : SystemException
[System.Serializable]
public class XamlParseException : SystemException
public class XamlParseException : SystemException
[<System.Serializable>]
type XamlParseException = class
inherit SystemException
type XamlParseException = class
inherit SystemException
Public Class XamlParseException
Inherits SystemException
- 繼承
- 屬性
備註
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) |
適用於
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應