浅析C#文档自动化实现

开发 后端 自动化
C#文档自动化是什么概念?C#文档自动化是如何实现的?C#文档自动化的特点是什么呢?本问就向你介绍详细内容。

C#文档自动化了解之前我们先来了解什么是C#文档自动化,熟悉java的程序员都知道,在java中有一种“文档注释”。采用这种注释之后,使用相应的命令,我们就可以得到与代码相关的文档说明。如今,在.net的世界中C#也提供了相同的功能。如果结合相应的工具,它还可以为我们产生漂亮的WEB风格的文档。

C#文档自动化初步认识:

在C#中文档注释对应的符号是:///。但光使用它还是不能为我们产生代码文档,还必须使用特殊的标记才行。这些标记实际上是XML标记,最常用的是< summary >。例如:

  1. /// <summary>  
  2.  
  3. /// A method with a string array param.  
  4.  
  5. /// </summary>  
  6.  
  7. public void Koo(string[] ss) {}  

C#文档自动化的特点:

但是,并不是所有使用文档注释和这些标记的地方编译器都会为我们生成文档,它还会看这些标记是否与一些代码结构相关联。例如:

  1. /// <summary>  
  2.  
  3. /// 不产生这行  
  4.  
  5. /// </summary>  

就不产生任何文档。这些代码结构必须是:class, struct, enum, method, property, field, indexer, delegate, 或event.

C#文档自动化之产生文档的命令

◆命令行:csc /doc: ….xml …..cs;

◆如使用VS.net,则:项目 -> 属性 -> 配置属性 -> 生成 -> 输出 -> xml文档文件(在此填写文件名和路径);

◆如要生成web注释:工具 ->生成注释 web......。

C#文档自动化的初步认识就向你介绍到这里,希望对你了解和学习C#文档自动化有所帮助。

【编辑推荐】

  1. C#代码格式化实际应用解析
  2. C#调用浏览器的功能实现浅析
  3. C#调用浏览器的原理及实现浅析
  4. C#文件浏览器制作的详细过程
  5. C#货币格式转化实例解析
责任编辑:仲衡 来源: host01.com
相关推荐

2009-08-12 16:26:30

C#读取XML文档

2009-08-07 17:01:22

C#调用QuickTe

2009-09-09 16:53:49

C# XmlSeria序列化

2009-08-28 17:34:14

读取word文档

2009-08-12 15:26:38

C#读取XML文档

2009-09-01 13:13:28

C#打开Word文档

2024-04-30 08:00:00

人工智能自动化文件处理

2009-09-27 10:43:13

C#合并多个WORD文

2020-01-16 09:00:00

AI人工智能ML

2009-09-01 18:29:24

C#实现多个接口

2009-08-31 16:48:02

C#实现IDispos

2009-09-02 15:34:37

C#实现插件构架

2009-08-31 10:38:34

C#变量初始化

2009-08-14 10:35:25

C#最小化编写

2009-08-12 16:46:22

C#读取XML文档

2009-08-26 09:54:45

C#打印预览C#打印

2009-09-02 17:24:44

C#关机代码

2009-08-13 18:15:06

C#继承构造函数

2009-08-28 16:03:15

C#程序实现鼠标移动

2009-09-07 09:36:29

C# DisposeDispose方法
点赞
收藏

51CTO技术栈公众号