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

时间:2017-10-24 14:36:36

标签: c# visual-studio wcf

如何为自动生成的代码生成带有documentaton(doxygen)的模板?

更加谨慎:我在C#应用程序中使用了多个连接服务。 因此Visual Studio生成一些文件,包括" Reference.cs"使用WCF服务方法的包装类。

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

e.g。

//------------------------------------------------------------------------------
// <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评论,例如&#34; autogenerated class&#34;在我的代码片段的每个COMMENT NEEDED部分。注意:我添加了COMMENT NEEDED评论只是为了说明我的问题。它们不是发电机输出的一部分。

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

1 个答案:

答案 0 :(得分:1)

似乎VS不使用可编辑的T4模板来生成代理类,就像在其他auto-gen senarios中一样。您可以使用针对svutil构建的工具。

Custom WSDL Publication

Make svcutil pick up documentation from C# files?