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 将 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 安全注意事项 或 XAML 概述（WPF）的“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 服务