在c/c++,java中,有两种注释,一种是单行注释,即两根反斜杠(//),另一种是多行注释,即以/*开头,以*/结尾。
在java中,多行注释(multiline comment)分为两种形式:
1.普通多行注释,比如
复制代码 代码如下:
/*
*多行注释
*/
2.javadoc注释,比如
复制代码 代码如下:
/**
*javadoc注释
*/
当java源文件编译的时候,javadoc工具会读取源文件当中的javadoc注释内容,并生成相应的html文档。供开发者参阅api相关的内容。
在c#中采用了另外一种形式,即xml。
为了能够在编译过程中生成xml文档,需要一种来标记来标注注释。即三根反斜杠。
下面是一个简单的例子:
复制代码 代码如下:
namespace mynamespace
{
/// <summary>
/// 这是一个普通的类
/// </summary>
public class person
{
/// <summary>
/// 这是标识的id
/// </summary>
public string id { get; protected set; }
/// <summary>
/// 这是姓名
/// </summary>
public string name { get; set; }
/// <summary>
/// 这是年龄
/// </summary>
public int age { get; set; }
/// <summary>
/// 这是构造函数
/// </summary>
/// <param name="id">id</param>
/// <param name="name">姓名</param>
/// <param name="age">年龄</param>
public person(string id, string name, int age)
{
this.id = id;
this.name = name;
this.age = age;
}
/// <summary>
/// 介绍自己啦
/// </summary>
public void introducemyself()
{
console.writeline("my name is {0}, my age is {1}", name, age);
}
/// <summary>
/// 计算两者之和
/// </summary>
/// <param name="a">左操作数</param>
/// <param name="b">右操作数</param>
/// <returns>两者和</returns>
public int calculate(int a, int b)
{
return a + b;
}
/// <summary>
/// 讲话啦
/// </summary>
/// <param name="msg">讲的内容</param>
public void saysomething(string msg)
{
console.writeline(msg);
}
}
}
编译该文件: csc /doc:test.xml test.cs
查看生成的xml文档:
复制代码 代码如下:
<?xml version="1.0"?>
<doc>
<assembly>
<name>mynamespace</name>
</assembly>
<members>
<member name="t:mynamespace.person">
<summary>
这是一个普通的类
</summary>
</member>
<member name="m:mynamespace.person.#ctor(system.string,system.string,system.int32)">
<summary>
这是构造函数
</summary>
<param name="id">id</param>
<param name="name">姓名</param>
<param name="age">年龄</param>
</member>
<member name="m:mynamespace.person.introducemyself">
<summary>
介绍自己啦
</summary>
</member>
<member name="m:mynamespace.person.calculate(system.int32,system.int32)">
<summary>
计算两者之和
</summary>
<param name="a">左操作数</param>
<param name="b">右操作数</param>
<returns>两者和</returns>
</member>
<member name="m:mynamespace.person.saysomething(system.string)">
<summary>
讲话啦
</summary>
<param name="msg">讲的内容</param>
</member>
<member name="p:mynamespace.person.id">
<summary>
这是标识的id
</summary>
</member>
<member name="p:mynamespace.person.name">
<summary>
这是姓名
</summary>
</member>
<member name="p:mynamespace.person.age">
<summary>
这是年龄
</summary>
</member>
</members>
</doc>
如果是在visual studio,需在项目属性的生成选项卡中选中生成xml文件,并指定路径和文件名。
这样,当您在使用相应的类或者方法时,我们利用ide自带的提示工具查看该类或该方法的简要:
您可能感兴趣的文章:
如您对本文有疑问或者有任何想说的,请点击进行留言回复,万千网友为您解惑!
网友评论