XamlParseException 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示来自 WPF 分析器的、特定于分析器的异常的异常类。 此异常用于 .NET Framework 3.0 和 .NET Framework 3.5 中的 XAML API 或 WPF XAML 分析器操作,或者通过调用 XamlReader API 而特别用于 WPF XAML 分析器。
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 Directive。 |
方法
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 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈