CSDN首页 空间 新闻 论坛 Blog 下载 读书 网摘 搜索 .NET Java 视频 接项目 求职 在线学习 买书 程序员 通知
英特尔®游戏设计大赛100美元现金周周送 专题改版:Java Web 专题
CSDN社区
搜索 收藏 打印 关闭
CSDN社区 >  .NET技术 >  C#

///注释和/,/*有什么区别吗?

楼主cymwllbggyje(可乐加冰)2003-06-01 04:29:41 在 .NET技术 / C# 提问

/用来单行注释,  
  /*   */用来做多行注释,  
  ///是什么呢,  
  一直想不明白。 问题点数:0、回复次数:3Top

1 楼ArLi2003(阿利,MSN:url@163.com)回复于 2003-06-01 06:42:41 得分 0

//   单行注释  
  /*   */   多行就不说了  
   
  ///是XML注解,简单的说,比如下面这个简单的例子:  
   
  ///   <summary>保存文件,成功返回null,否则返回错误信息</summary>  
  ///   <param   name="fileFullName">要保存的文件名</param>  
  ///   <param   name="fileBody">文件内容</param>  
  ///   <returns>结果值</returns>  
  internal   string   SaveFileOf(string   fileFullName,string   fileBody)   {  
  try{  
  FileStream   ObjFile   =   new   FileStream(fileFullName,FileMode.Create,FileAccess.Write,FileShare.Read);  
  StreamWriter   sw   =   new   StreamWriter(ObjFile,System.Text.Encoding.Default);  
  sw.Write(fileBody);  
  sw.Close();  
  ObjFile.Close();  
  return   null;  
  }catch   (Exception   e){  
  return   e.Message.ToString();  
  }  
  }  
   
  其中各项并不是源代码注解,而是一个XML   形式的映射,你在用IDE时输入SaveFileOf   这时会自动弹出提示就是<summary></summary>   之间的内容,下面是参数也是一样自动提示,就好象VS自己的函数提示一样,包括重载次数等等。。  
   
  如果该程序体是在dll   中,那么可以用    
   
  csc   /t:savefile.dll   /doc:savefile.xml   savefile.cs  
   
  输出一个xml   文件,你可以将这个xml   文件和DLL一起发布给第三方,那么在VS的IDE中引用该DLL时也会自动载入savefile.xml   从而起到了自动注解的作用(也就是所谓的CTRL+KI   的快速信息)Top

2 楼ArLi2003(阿利,MSN:url@163.com)回复于 2003-06-01 06:49:25 得分 0

补充一下:  
   
  ///   <summary>保存文件,成功返回null,否则返回错误信息</summary>  
  ///   <param   name="fileFullName">要保存的文件名</param>  
  ///   <param   name="fileBody">文件内容</param>  
  ///   <returns>结果值</returns>  
   
  summary   是当前行往下数最近一个函数的作用注解(上例为SaveFileOf函数)  
  param   name=xxx   是该函数的各参数注解  
  returns   是返回值注解  
   
  还有<code></code>等都是常用的,这些在MSDN都有说明,你可前往查阅  
   
  也就是说,你比如输入   MessageBox.Show   这时会有自动的提示(快速信息)说明它的重载次数、函数名及各参数,而你自己写的函数用上面的注解也可以做到这一点,这就是它的作用,对类、结构、函数等等都适用Top

3 楼lufly2000(凌绝顶)回复于 2003-06-01 08:55:54 得分 0

是xml注释,vs可以用来生成xml文件  
   
  前面师兄讲的很详细。。。Top

相关问题

  • ->和.有什么区别
  • BYTE 和 byte 什么区别??
  • :=和=的区别是什么?
  • AnsiString和char什么区别
  • ■■■OnPaint和Paint什么区别?
  • Web.HttpContext.Current.Request.MapPath和....Server.MapPath 什么区别?
  • Me和MyBase什么区别?
  • <%%>和<Script>有什么区别?
  • WSPSend和WSPSendTo什么区别?
  • exist 和 in 有什么区别?

关键词

  • 函数
  • 文件
  • 内容
  • 信息
  • dll
  • xml
  • null
  • 注解
  • 注释
  • savefileof

得分解答快速导航

  • 帖主:cymwllbggyje

相关链接

  • CSDN .NET频道
  • .NET类图书
  • C#类图书
  • .NET类源码下载

广告也精彩

反馈

请通过下述方式给我们反馈
反馈
提问
网站简介|广告服务|VIP资费标准|银行汇款帐号|网站地图|帮助|联系方式|诚聘英才|English|问题报告
世纪乐知(北京)网络技术有限公司 版权所有, 京 ICP 证 020026 号
北京创新乐知广告有限公司 提供技术支持
Copyright © 2000-2007, CSDN.NET, All Rights Reserved
GongshangLogo