Visual Studio:自动生成代码的文档



如何使用文档(doxygen)为自动生成的代码生成模板?

更确切地说:我在 C# 应用程序中使用了多个连接的服务。因此,Visual studio生成一些文件,包括"Reference.cs",其中包含WCF服务方法的包装类。

现在我正在为我的整个项目生成 doxygen 文档,并获得空白命名空间和类文档。

例如

//------------------------------------------------------------------------------
// <auto-generated>
//     Dieser Code wurde von einem Tool generiert.
//     Laufzeitversion:4.0.30319.42000
//
//     Änderungen an dieser Datei können falsches Verhalten verursachen und gehen verloren, wenn
//     der Code erneut generiert wird.
// </auto-generated>
//------------------------------------------------------------------------------
/// COMMENT NEEDED
namespace MyApp.ActionService {
[...]   
/// COMMENT NEEDED
public interface IActionsService {
[...]
/// COMMENT NEEDED
public partial class ActionsServiceClient : [...]

我需要的是代码片段的每个"需要注释"部分中的通用doxygen注释,例如"自动生成的类"。注意:我添加了需要评论的评论只是为了说明我的问题。它们不是发电机输出的一部分。

是否可以编辑代码生成器的模板?

看起来 VS 不像其他自动生成的 senarios 那样使用可编辑的 T4 模板来生成代理类。为此,您可以使用针对 svutil 构建的工具。

自定义 WSDL 发布

让 svcutil 从 C# 文件中获取文档?