2010-07-06 158 views
6

有没有人知道是否有一个XSD文件可用于验证在使用/ doc选项编译C#项目时生成的XML文档?XSD为C#生成的XML文档?

我想在生成它之后手动修改该文件,并且正在寻找一种简单的方法来确认我没有损坏该文件的结构。

谢谢。

+0

并不严格回答你的问题,但这里的[推荐的标签列表(http://msdn.microsoft.com/en-us/library/5ast78ax。 aspx)链接到使用示例。注意:您可以在页面上选择适用的Visual Studio版本。 – Steven 2014-05-20 18:37:33

回答

2

今天偶然发现了这个老问题。我没有看到微软的文档,也没有看到其他项目,我认为可能有兴趣开发这样的模式;即Sandcastle和(长期停用)NDoc项目的来源。

由于缺乏尝试自行定义模式的问题,我可以建议的一件事就是使用将从XML生成XSD的许多工具之一。微软将XSD.EXE作为Visual Studio及其SDK的一部分。

您可以编写虚拟源,练习每个XML文档注释标记,为其构建XML文档文件,然后使用XSD.EXE。从中生成XSD,并在处理完成后使用它来验证XML文档。但我认为这可能会变得不那么微不足道。另外,XML文档注释涉及类型和代码元素,并且模式不会捕捉到很多东西;例如,验证<param>标记的name属性是否仍引用C#源代码中的实际参数名称。编译器在构建时验证这些元素。但是,如果您后处理XML文档,则需要一个自定义工具,该工具引用了原始C#源代码或生成的程序集来重新验证此类引用。

8

我终于崩溃了,写了一个:XSD for Xml Comments for .NET Documentation

+0

我知道这是一个旧的答案,但我试图找到有关成员元素名称属性格式的文档。我看到了正则表达式,但正在寻找关于如何解释这个问题的文档。 – Jeremy 2013-11-13 21:14:31