Take a look at GW

【Visual Studio】Visual C# 中XML注释的使用(含注释在开发时显示换行)

为函数方法注释说明要用到 xml 语句 <summary> 段落说明 </summary> 、<para> 新段示例说明 </para>、<para>  </para> 空行要加入全角空格

下面的注释会破坏原有标注结构:

[csharp] view plain copy
  1. /// <summary> 第一行 说明  
  2. /// <para>第二行说明</para>  
  3. /// <para> ←最前面的空格要加入全角空格才会显示</para><para> </para><para> 上面一行是空行</para>  
  4. /// <param name="s"> s 为表名,不要加 .xml 后缀</param>  
  5. /// <para> 异常:...</para>  
  6. /// <returns> 返回:成功 - true;失败 - false。</returns>  
  7. ///</summary>  
  8. private void getXmlTable(string s, DataGridView dataGView, ComboBox com, Button ton){}  


原语句:

[csharp] view plain copy
  1. /// <summary> 第一行 说明  
  2.         /// <para>第二行说明</para>  
  3.         /// <para> ←最前面的空格要加入全角空格才会显示</para><para> </para><para> 上面一行是空行</para>  
  4.         /// <para> </para>  
  5.         /// <para> 异常:《说明...》</para>  
  6.         ///</summary>  
  7.         /// <param name="s"> s 为表名,不要加 .xml 后缀</param> /// <returns> 返回:成功 - true;失败 - false。</returns>  
  8.         private void getXmlTable(string s, DataGridView dataGView, ComboBox com, Button ton){}  


原文链接:Visual C#XML注释的使用

posted @   HDWK  阅读(1448)  评论(0编辑  收藏  举报
编辑推荐:
· 从 HTTP 原因短语缺失研究 HTTP/2 和 HTTP/3 的设计差异
· AI与.NET技术实操系列:向量存储与相似性搜索在 .NET 中的实现
· 基于Microsoft.Extensions.AI核心库实现RAG应用
· Linux系列:如何用heaptrack跟踪.NET程序的非托管内存泄露
· 开发者必知的日志记录最佳实践
阅读排行:
· TypeScript + Deepseek 打造卜卦网站:技术与玄学的结合
· Manus的开源复刻OpenManus初探
· AI 智能体引爆开源社区「GitHub 热点速览」
· C#/.NET/.NET Core技术前沿周刊 | 第 29 期(2025年3.1-3.9)
· 从HTTP原因短语缺失研究HTTP/2和HTTP/3的设计差异
点击右上角即可分享
微信分享提示