文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

VS XML注释插件常见问题是什么

2023-06-17 19:34

关注

今天小编给大家分享一下VS XML注释插件常见问题是什么的相关知识点,内容详细,逻辑清晰,相信大部分人都还太了解这方面的知识,所以分享这篇文章给大家参考一下,希望大家阅读完这篇文章后有所收获,下面我们一起来了解一下吧。

这些手工标记是非常有用的,如果恰当地设置他们,对导出成外部说明文件将非常有帮助。如果碰到是预先定义的xml标记,编译器可以把这些注释以文本输出;如果是编译器不认识的xml标记,编译器会逐字的把所有内容都输出,这意味着你可以使用自己定义的标记。

适当的设置,C#编译器并不格式化VS XML注释,而是以xml文件输出。下面的步骤将演示如何让C#编译器把VS XML注释输出为xml文件。右键点击解决方案资源管理器中的工程项,打开工程的属性页,点击属性。对话框出现后,点击配置属性目录。点击生成节点。

在右边的框中有输出--xml文档文件,这里就是设置丛VS XML注释生成xml文件的文件名。(注:这里设置的是相对路径,不是绝对路径)。在我的例子中,我使用GiveHelpDoc.xml作为文档名,如果这里没有输入任何值,这将是默认设置。

公认的标记我把VS XML注释标记分类两大类:***类是设置标记,我叫他们主标记。他们在一组标记的开始,而且不会在标记内部出现。第二类是设置标记包含的标记,我叫他们支持标记。支持标记和html标记的区别在于:支持标记采用的是小写,html标记采用的是大写,显示了我将要讨论的支持标记和主标记。

GiveHelpTransforms.cs部分代码:

  1. namespace GiveHelp  

  2. {  

  3. <remarks> 

  4. Class that contains functions to do transformations to help files.  

  5. The source XML is loaded into the <see cref="SourceXML"/> property   

  6. (e.g. <c><I>obj</I>.SourceXML = "<I>XML goes here</I>"</c>). One of   

  7. the associated member functions (<see cref="GiveTypeListHTMLHelp"/  

  8. ><see cref="GiveMemberListHTMLHelp"/><see   

  9. cref="GiveMemberHTMLHelp"/>)   

  10. is called to initiate and then return the transformation.  

  11. <para> 

  12. <list type="table"> 

  13. <listheader> 

  14. <term>Help Page</term> 

  15. <description>Function to call</description> 

  16. </listheader> 

  17. <item><term>List of Types</term> 

  18. <description>GiveTypeListHTMLHelp</description></item> 

  19. <item><term>List of members</term> 

  20. <description>GiveMemberListHTMLHelp</description></item> 

  21. <item><term>Help for a single member</term> 

  22. <description>GiveMemberHTMLHelp</description></item> 

  23. </list> 

  24. </para> 

  25. </remarks> 

  26. <permission cref="">public</permission> 

  27. <example><code> 

  28. // create the class that does translations  

  29. GiveHelpTransforms ght = new GiveHelpTransforms();  

  30. // have it load our XML into the SourceXML property  

  31. ght.LoadXMLFromFile("E:\\Inetpub\\www-  

  32. root\\GiveHelp\\GiveHelpDoc.xml");  

  33.     

  34. // do the translation and then write out the string  

  35. Response.Write( ght.  

  36. GiveMemberHTMLHelp(Request.QueryString.Get("Type"),  

  37. Request.QueryString.Get("Member")) );  

  38. </code></example> 

  39.  public class GiveHelpTransforms  

  40.  { 

以上就是“VS XML注释插件常见问题是什么”这篇文章的所有内容,感谢各位的阅读!相信大家阅读完这篇文章都有很大的收获,小编每天都会为大家更新不同的知识,如果还想学习更多的知识,请关注编程网行业资讯频道。

阅读原文内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯