大网数据广告活动
.NET 与 C# 开发

引发异常

· 52CE 我爱测

本部分介绍的异常引发准则要求对执行失败的含义进行明确定义。 只要成员无法执行其指定操作(成员名称所体现的含义),就会导致执行失败。 例如,如果 OpenFile 方法无法将打开的文件句柄返回给调用方,则视为执行失败。

本部分介绍的异常引发准则要求对执行失败的含义进行明确定义。 只要成员无法执行其指定操作(成员名称所体现的含义),就会导致执行失败。 例如,如果 OpenFile 方法无法将打开的文件句柄返回给调用方,则视为执行失败。

大多数开发人员已经习惯使用异常来处理用法错误,例如除零或空引用。 在 Framework 中,异常用于所有错误条件,包括执行错误。

X DO NOT 返回错误代码。

异常是框架中报告错误的主要方式。

✓ DO 引发异常来报告执行失败数。

✓ CONSIDER 通过调用来终止进程System.Environment.FailFast(.NET Framework 2.0 功能) 而不是引发异常,如果你的代码遇到进一步执行不安全的情况。

X DO NOT 正常流控制,如有可能使用异常。

除系统故障和存在潜在争用条件的操作这两种情况外,框架设计者应设计 API,以便用户可以编写不会引发异常的代码。 例如,可以提供在调用成员之前检查前提条件的方法,以便用户可以编写不会引发异常的代码。

用于检查另一个成员的前提条件的成员通常被称为 tester(测试者),实际执行该工作的成员称为 doer(实施者)。

有些情况下,Tester-Doer 模式可能会产生不可接受的性能开销。 在这种情况下,应考虑使用所谓的 Try-Parse 模式(有关详细信息,请参阅异常和性能)。

✓ CONSIDER 引发异常的性能影响。 Throw 速率大于每秒 100 会显著影响大多数应用程序的性能。

✓ DO 由于的成员冲突而引发的公开可调用的成员的所有异常协定 (而不是系统故障),并将它们视为协定的一部分的文档。

作为协定一部分的异常在协定的不同版本中应保持一致(即,不应更改异常类型,并且不应添加新的异常)。

X DO NOT 具有或不会引发的公共成员根据某些选项。

X DO NOT 具有作为返回值返回异常的公共成员或out参数。

如果选择从公共 API 返回异常而不是引发它们,会丧失基于异常的错误报告的优势。

✓ CONSIDER 使用异常生成器方法。

从不同位置引发相同的异常是很常见的。 为避免代码膨胀,请使用可创建异常并初始化其属性的辅助方法。

此外,引发异常的成员不会被内联。 或可通过将引发语句移动到生成器内来实现成员内联。

X DO NOT 异常筛选器块中引发异常。

当异常筛选器引发异常时,CLR 会捕获该异常,筛选器会返回 false。 此行为与执行并显式返回 false 的过滤器行为无法区分,因此很难进行调试。

X AVOID 显式引发 finally 块中的异常。 隐式引发的异常导致的调用引发的方法是可接受的。

部分版权 © 2005, 2009 Microsoft Corporation。保留所有权利。

经 Pearson Education, Inc 授权,转载自框架设计准则:可重用的 .NET 库的约定、习惯用语和模式,第 2 版 作者:Krzysztof Cwalina 和 Brad Abrams,由 Addison Wesley Professional 于 2008 年 10 月 22 日印发,作为 Microsoft Windows 开发系列的一部分。

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 KrzysztofCwalina)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 10/22/2008
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。