Visual Studio 2008 XML 文档
我似乎在项目的属性页的“配置属性”文件夹下找不到“构建”选项。 我一直在到处寻找,试图弄清楚如何做到这一点。
我按照这里的指示操作: http://msdn.microsoft.com/en- us/magazine/cc302121.aspx
更具体地说:http:// /msdn.microsoft.com/en-us/library/azt1z1eh.aspx (“在 Visual Studio 中构建 XML 文档示例”部分)
我想在构建中为我的项目生成 XML 注释,但我的“配置属性”窗口下面没有“文件夹”或“构建”选项。
我正在使用 Visual Studio Team System 2008,有什么想法吗?
编辑-> 这是一个网站[无项目],用 C# 和 VB.NET 编写。
我需要下载任何工具吗? 我找到了 GhostDoc 但这对我没有多大帮助。
I can't seem to find the "Build" option under "Configuration Properties" folder in the Property Pages of my project. I've been looking everywhere trying to figure out how to do it.
I followed the direations here: http://msdn.microsoft.com/en-us/magazine/cc302121.aspx
More specifically here: http://msdn.microsoft.com/en-us/library/azt1z1eh.aspx
("To build the XML Documentation sample within Visual Studio" section)
I want to generate XML comments for my project in the build, but my "Configuration Properties" window does not have "folders" or a "Build" option under it.
I'm using Visual Studio Team System 2008, any ideas?
EDIT -> This is a website [project-less] and it is written in both C# and VB.NET.
Do I need to download any tools? I found GhostDoc but that's not helping me very much.
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论
评论(6)
我不确定“配置属性”文件夹是什么意思。 我没有类似的东西 - 如果我只需双击项目下的“属性”(在解决方案资源管理器中),它就会出现属性页面,其中包含以下选项卡(对于 VS 2008 Pro 中的控制台应用程序):
这听起来像您正在查看的屏幕吗? 你能截取你所拥有的内容的屏幕截图吗?
如果您双击“属性”,您会得到什么?
I'm not sure what you mean by the "Configuration Properties" folder. I don't have anything like that - if I just double click on "Properties" under the project (in Solution Explorer), it comes up with the properties page which has the following tabs (for a console app in VS 2008 Pro):
Does this sound anything like the screen you're looking at? Can you grab a screenshot of what you've got?
If you just double click on "Properties" what do you get?
您使用的是 C# 还是 VB.NET? 在 VB.NET 中,属性页看起来有点不同。 编译属性页上有一个复选框,指出“生成 XML 文档文件”。 确保已检查。
Are you using C# or VB.NET? In VB.NET, the Properties pages look a bit different. There is a checkbox on the Compile property page that states "Generate XML documentation file". Make sure it's checked.
我有一个网络服务,我想为其创建此类文档。 这也是一个网站项目,所以我没有菜单。 针对这种情况找到解决办法了吗?
I have a webservice that I'd like to create this kind of documentation for. It's also a website project, so I don't have the menu. Has a solution been found for this situation?
右键单击项目的任何类库并选择属性,然后您将找到“构建”选项卡选项...您可以在其中指定 xml 文档文件路径。 -易卜拉欣
right click of any class library of your project and select properties then you will find Build tab option... there you can specify the xml documentation file path. -ibrahim
您引用的 MSDN 杂志文章已过时。 2008 年和 2010 年文档的链接已更新并提供了正确的说明。
通过选择项目 | 打开 XML 注释。 从菜单中选择属性,然后转到构建页面。 您可能会注意到,对于许多监视器,您必须在构建页面上向下滚动才能找到有关 XML 注释的部分。
The MSDN magazine article you reference is out of date. The link to the 2008 and 2010 documentation has been updated and gives the proper directions.
Turn on XML comments by choosing Project | Properties from the menu and turning to the Build page. You might note that with many monitors, you will have to scroll down on the Build page before finding the section on XML comments.
能够为网络服务(网站项目)构建文档是有意义的,因为它将被第三方使用。 Web 服务调用者可以使用 wcfextras 流通过 wsdl 使用 XML 文档。 这是否意味着我必须将仅包含两个 .cs 文件的解决方案分解到一个单独的项目中才能获取文档,或者还有其他方法吗? 谢谢。
It makes sense to be able to build docs for a webservice (a website project) since it will be consumed by a third party. The XML docs can be consumed by the web service caller via wsdl using the wcfextras flow. Does this mean I must break out my solution consisting of just two .cs file into a separate project in order just to get the doc or is there another way? Thanks.