C# 代码注释规范

C# 代码 XML 注释规范及其 .chm 帮助文档生成 一.摘要 当我们进行程序开发时,面对一个大型项目,需要多人分工合作,每人实现一个模块。当我们需要调用他人编写的模块时,首先参考的不是源码部分,而是要去通读其代码注释部分。因此,代码注释是否规范标准,很大程度上影响着项目的开发进度。 .Net允许开发人员在源代码中插入XML注释,这在多人协作开发的时候显得特别有用。C#解析器可以把代码文件中的这些XML标记提取出来,并作进一步的处理为外部文档。在... 阅读详情

不要小瞧注释,因为自己写的Code在很长时间后在修改时,可能连自己都记不得了,还有在其他人接手自己的Case的时候,也会造成阅读困难;
   .NET提供四种注释
   一:类注释-在类的开始部分注释
     /*
     * 类说明
     *
     *
     */
   public class City
   {}
   二:类属性注释-在类的属性前注释
   //属性说明
   public string City_Name
     {
         get { return this._city_name; }
         set { this._city_name = value; }
     }
   三:类方法注释-在类的方法声明前注释
   /// <summary>
   /// 方法说明
   /// </summary>
   public void Insert()
   {}
   四:代码间注释-在代码之间注释
        try
            {
                //<说明>
                ListViewItem lvi = Getlvi(car);
                this.lvCar.Items.Add(lvi);
            }
            catch (MessageException ex)
            {
                MessageBox.Show(ex.Message);
            }
每天学习一点点,每天进步一点点

 

1 using 上面的注释

//

// 名称: LeaveMessageMannage

// 描述: 业务逻辑类[bll](实体类[model], 数据访问类[bal])

// 创建人:张园园

// 创建时间:2008-08-27

// 最后修改人:(无)

// 最后修改时间:(无)

// 版权所有 (C) :

大连锦程软件技术开发有限公司 

2 方法注释

#region 插入留言信息

        /// <summary>

        /// 插入数据

        /// </summary>

        /// <param name="model"></param>

        定义方法

#endregion

c#注释规范 公司代码整改,特将c#注释规范总结下: c#注释一般如下: 1:单行注释,用//开始。 //这是一个注释 2:块注释,/**/ /* 注释内容, 可以随意换行 */ 3:XML注释方式(Extensible Markup Language 可扩展标记语言),///开始 /// <summary> ///这是一个加法求和方法 /// </summary> /// <param name=" 阅读详情

相关推荐

【编码规范篇】 C#编码规范 代码规范总结,包括命名规范,代码规范 注释规范等_c

本文整理了一些C#中较为常用的一些编码规范,目的是能够让我们编写出更优美简洁的代码。多数的规范并没有强制性,只是作为一个样例模板以供参考学习使用。尤其是对于新手来说,在前期编写代码的过程中养成一个好的习惯,后面就可以完全放飞自我啦。如果文中哪里有错误或者有更好的解决方案,也希望可以指出共同进步~部分内容参考链接C# 7 草稿规范。

2401_84185951的博客 1372

C# 注释详解

C# 注解使用方法

z961257590的博客 4494

rk3568 RGMII KSZ8795 MAC TO MAC

参考《Rockchip_Developer_Guide_Linux_MAC_TO_MAC_CN.pdf》

明天乌儿会歌唱 6494

C#中的三种注释与其快捷键、以及创建类时自动生成类的注释的设置方法

/// <summary> /// 这个方法的作用是求两个整数之间的最大值 /// </summary> /// <param name="n1">第一个整数</param> /// <param name="n2">第二个整数</param> /// <returns>返回较大的整数</returns> public static int GetMax(int n1,int n2) { return n1>n2?n1:n2; } ———————————————

Ariel_欢 1万+

【NVIDIA驱动的顽固问题】---- /dev/sdax:clean,xxx/xxx files,xxx/xxx blocks ---- 最全解决方法

本文的意义在于整理总结关于此问题的全部解决方法,希望能给大家节约时间。

lc1852109的博客 3128

笔记——Oracle19c

Oracle阅读笔记

weixin_63819458的博客 1350

C#中常见的三种注释

在C#中,注释的作用主要有以下两点:(1)注释内容;(2)注销代码,按照注释的内容,主要可分为三种类型:【1】单行注释;【2】多行注释;【3】代码块注释。

weixin_46022853的博客 4040

泛微OA与金蝶云星空深度集成实战:审批与表单双场景解析

本文深入解析泛微OA与金蝶云星空的深度集成实战,聚焦审批流程与表单对接两大核心场景。通过具体案例,详细阐述了如何实现业务数据与审批流程的自动联动,打破数据孤岛,提升企业运营效率与数据一致性,并分享了接口设计、安全策略及实战避坑指南。

4k5l6j7h8的博客 466

C#基础(注释、变量常量、数据类型、运算符、输入输出、类型转换内置方法)

赋值运算符:简单赋值运算符(=)、加法赋值运算符(+=)、减法赋值运算符(-=)、乘法赋值运算符(*=)、除法赋值运算符(/=)、取余赋值运算符(%=);算术运算符:加(+)、减(-)、乘(*)、除(/)、取模(%);指针类型:指针类型变量存储另一个类型的内存地址,C#中的指针与C或C++中的指针有相同的功能,声明指针类型的语法: type* identifier;比较运算符:大于(>)、小于(=)、小于等于(

这个博主还没想好名字的博客 1021

人工智能在软件测试中的广泛应用领域

人工智能在软件测试中的应用领域涵盖了自动化测试、缺陷预测和缺陷检测、智能化测试报告生成等方面。以上提供的示例代码只是其中的一小部分,实际上,人工智能在软件测试中还有许多其他的应用。通过结合人工智能和软件测试,可以提高测试效率和质量,减少测试工作的人力成本,并帮助开发人员更好地理解和改进软件产品。人工智能(Artificial Intelligence,简称AI)在软件测试领域的应用越来越广泛。下面将介绍几个人工智能在软件测试中的主要应用领域,并提供一些相关的源代码示例。

FycPerformance的博客 462

运动想象 (MI) 分类学习系列 (19) : EEG-TransNet

本文提出了一种基于注意力机制的卷积神经网络(EEG-TransNet),用于运动想象脑电图(MI-EEG)解码。该方法创新性地通过平均池化和方差池化提取多模态时间信息,并结合自注意力模块捕获长期依赖关系。消融实验表明,方差池化比最大池化更有效(p<0.05),且注意力模块和卷积编码器对特征判别性至关重要。可视化分析验证了该方法能学习到更具判别性的紧凑特征。该工作为MI-EEG解码提供了新的多尺度时间信息融合视角,代码已开源。

走在深度学习前沿的小宋 358

c#之 三种注释方法以及快捷键

C#的三种注释方法 第一种: 常规的双斜杠: // 例如 //这是一个注释 第二种: /* 注释内容, 可以随意换行 */ 第三种:代码块上面的三斜杠注释,用来解释代码块的具体含义,便于后来者理解,例如: /// ///管理层的工资 /// /// 工资 /// 分红 /// public double Calculation(double money) { int fh = 10000...

音尘啊 7万+

Codex入门00-初识神器(小白入门:到底什么是Codex CLI,和ChatGPT写代码有什么不同?)

OpenAI Codex CLI 是 OpenAI 于2025年推出的终端原生AI编程代理,不是在网页里聊天写代码,而是直接在你的终端里自主读代码、改文件、跑命令。它拥有三种安全模式、/goal 持久化任务、云端沙箱执行等独特能力。本文从零介绍 Codex CLI 的核心概念、与 ChatGPT 写代码的本质区别、典型使用场景和费用说明,让你全面认识这个改变开发方式的神器。

yueyeguzhuo的专栏 302

【编码规范篇】| C#编码规范 代码规范总结,包括命名规范,代码规范 注释规范等

在我们程序员日常开发的过程中,会编写代码是一个最基本且常规的操作。而作为一名合格的软件工程师,出产物就应该具备工程的健壮性和美观性,因此编码规范是作为软件工程师的职业素养。但是就编码规范而言,可能大多数程序员都是按照自己的长久习惯进行代码编写,并没有遵循一个约定好的编码规范。所以本篇就来对C#中的编码规范做一个详细的总结整理,并对一些超级常用的做一个重点解析!对于编程而言,大多数语言的编码规范基本上是遵循一些相同的规范标准的,除去少些个语言有一些特殊用法之外。

努力前行,总会成为自己心中的那道光 4万+

Autosar_MCAL_Port

PORT Driver就是对微控制器(MCU)的整个PORT模块进行初始化配置。很多端口和管脚被分配有多种不同的功能,即可以进行引脚功能复用,比如通用I/O、adc、pwm、spi等功能。因此,对PORT必须有一个整体的配置和初始化,对各管脚的具体配置和使用取决于微控制器和ECU的引脚功能分配。PORT初始化数据应当尽可能高效地写到每个端口。DIO驱动中所用到的端口的配置和初始化都是在PORT驱动模块中完成的。因此,在使用DIO功能之前,应先进行PORT的初始化。1、PortContainer说明。

不断debug,优化中…… 239

win10 跳过U8环境检测的IE WebControls.rar

win10 安装u8的时候 提示IE WebControls 不通过,这个工具可以欺骗u8的检查。 跳过U8环境检测的IE WebControls。提示导入失败后,重新检测通过。

C#代码注释规范及文档生成

点击打开链接

Only X World 3752

NTscan扫描工具

ntscan是一个扫描器,可以扫描没有密码和弱密码的共享,先到配置文件中填写猜测的用户名和密码,扫描过程中右侧出现的是扫描日志。

C# 代码注释规范文档

C#代码规范

m0_58750788的博客 1317

怀旧版电脑GBC模拟器

再现原版GBC掌机的界面,电脑运行连游戏界面都一样大小,很怀旧,很真实,(英文版)强烈推荐,很小的文件,很难才找到的。

【编码规范篇】 C#编码规范 代码规范总结,包括命名规范,代码规范 注释规范等_c(2)

若要通过跳过不必要的比较来避免异常并提高性能,请在执行比较时使用。正例:MAX_XIAOY_COUNT。反例:MAX_xiaoy_COUNT。(而不是 |),如下面的示例所示。

2401_84185951的博客 813

代码规范之C#注释

注释:(摘抄,自己学习用)   了解一本书---> .Net设计规范 在C#中,程序注释有三种。 关于程序注释需要理解的是:注释是给阅读程序的人看的,不是给编译器或操作系统执行指令功能的,没有这个作用。 三种注释: 1. //单行注释; 2. /*   多行或一段注释   */ 3. ///<summ...

weixin_30396699的博客 129

c#小灶——4.注释和代码规范

为什么要写注释? 早上我写完了代码,我和我的朋友们都能看懂,到了晚上,我还能看懂,一周后,就只有上帝能看懂了…… 将来我们写的代码量是很大的,代码又不像我们自然语言这么好理解,可能过段时间我们就不认识自己的代码了,所以我们要养成写注释的好习惯。 团队合作当中,写了注释更容易使别人读懂你的代码。 注释的作用除了解释说明,还有一个比较常用,因为注释不被编译的特性,...

weixin_30293079的博客 156

GhostDoc不只是注释生成器:在Visual Studio里用它规范团队C++/C#代码文档风格

本文探讨了GhostDoc在Visual Studio中如何帮助团队规范C++/C#代码注释风格,提升协作效率。通过标准化注释模板、智能补全策略和与项目管理系统的集成,GhostDoc不仅生成注释,更实现了注释即规范的自动化工作流,显著减少沟通成本并提高文档质量。

weixin_30509393的博客 535

Unity3D C#代码注释规范及文档生成

在使用c#进行Unity3D游戏开发中,良好的注释和文档能让开发更有效率,条理更清晰。 本讲分为两个部分: 一:编写注释 二: 生成文档                          编写注释 开发注释是 // 帮助拓展代码 使用注释是 /// 帮助使用代码 开发注释:辅助开发,对变量或者函数等代码的后续开发做的注释。

ykr168age的专栏 7379
上一篇: C#命名规范之变量和方法参数命名
下一篇: C#代码规范
Mevin
博客等级 码龄18年 27粉丝 3原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值