0

当您在 C# 代码中编写 Xml 文档时(不确定 VB 是否支持此功能),如下所示:

/// <summary>
/// Gets or sets the identity of the Mail Server that is to be used to send the email.
/// </summary>
public string MailServer
{
    get { return _mailServer; }
    set { _mailServer = value; }
}

三斜杠注释中的 Xml 在 Intellisense 中使用,但似乎在早期版本的 Visual Studio(我认为是 2003)中有一个工具可以遍历代码并组装所有这些元素(以及对象名称) , etc) 以形成一个完整的 Xml 文档。我在 Visual Studio 2008、2010 和 2012 中找不到这个工具。

我很高兴开始学习如何使用 Sandcastle 以及所有这些,但这需要我一些时间,我现在需要这个东西来制作我正在尝试制作的一些文档。

所以问题是,既然这个工具曾经在 VS 中,它是否仍然存在,但我只是无法找到它(模糊)?或者我必须得到一个外部工具(最好是免费的)?

4

2 回答 2

2

生成 XML 文档文件属性确定是否在编译期间生成 XML 文件。您在项目设计器的构建页面上设置此属性。选择此选项后,XML 文档会自动发送到一个 XML 文件中,该文件将与您的项目具有相同的名称和 .xml 扩展名。

为 Visual C# 项目生成 XML 文档文件

  1. With a project selected in Solution Explorer, on the Project menu, click *Propertie*s.

  2. Click the Build tab.

  3. On the Build page, select XML documentation file. By default, the file is created under the specified output path, for example, "bin\Debug\Projectname.XML".

http://msdn.microsoft.com/en-us/library/vstudio/x4sa0ak0(v=vs.100).aspx

于 2013-08-28T16:28:52.650 回答
1

实际上,现在有一个 Sandcastle 构建器可以直接集成到 Visual Studio 中。它使事情变得容易。http://shfb.codeplex.com/

于 2013-08-28T16:23:46.510 回答