zoukankan      html  css  js  c++  java
  • 编写高质量代码改善C#程序的157个建议——建议153:若抛出异常,则必须要注释

    建议153:若抛出异常,则必须要注释

    有一种必须加注释的场景,即使异常。如果API抛出异常,则必须给出注释。调用者必须通过注释才能知道如何处理那些专有的异常。通常,即便良好的命名也不可能告诉我们方法会抛出那些异常,在这种情况下,使用注释是最好的手段。

            /// <summary>
            /// 注释
            /// </summary>
            /// <param name="value">输入参数注释</param>
            /// <returns>返回值注释</returns>
            /// <exception cref="System.IO.IOException">如果……,则抛出IOException</exception>
            public string SampleMethod(int value)
            {
                if (true)
                {
                    throw new IOException("一些IO异常");
                }
                //省略
            }

    转自:《编写高质量代码改善C#程序的157个建议》陆敏技

  • 相关阅读:
    #什么是spring#
    spark sql 判断一列是否包含某字符
    win10 安装微软商店
    python获取一段时间的日期
    css 网格
    css 网格属性总结
    css flex容器属性总结
    CSS Flexbox
    响应式Web设计
    css 伪类选择器
  • 原文地址:https://www.cnblogs.com/jesselzj/p/4753806.html
Copyright © 2011-2022 走看看