如何以编程方式将文档从 .xml 文件导入 .cs 文件？

Question

我在 .xml 文件中保存了如下所示的文档：

<?xml version="1.0"?>
<doc>
    <assembly>
        <name>ClassLibrary2</name>
    </assembly>
    <members>
        <member name="T:ClassLibrary2.Class1">
            <summary>
            Class1 Dummy documentation
            </summary>
        </member>
        <member name="M:ClassLibrary2.Class1.Func1">
            <summary>
            Func1 Dummy documentation
            </summary>
        </member>
    </members>
</doc>

而且我不会将文档导入到如下所示的 .cs 文件中：

namespace ClassLibrary2
{
    public class Class1
    {
        void Func1()
        {

        }
    }
}

这样在我导入后我的文件将如下所示：

namespace ClassLibrary2
{
    /// <summary>
    /// Class1 Dummy documentation
    /// </summary>
    public class Class1
    {
        /// <summary>
        /// Func1 Dummy documentation
        /// </summary>
        void Func1()
        {

        }
    }
}

如何以编程方式执行此操作？

我应该使用CodeDOM 还是Visual Studio？或Roslyn 或其他工具？

任何帮助将不胜感激，

提前致谢。

Answer 1

使用 CodeDom，Roslyn 是编译器平台，不会帮助您解决问题。

1. 将 cs 加载到代码域图中
2. 在图中找到方法/属性并添加 CodeCommentStatement - 见https://docs.microsoft.com/en-us/dotnet/framework/reflection-and-codedom/how-to-create-an-xml-documentation-file-using-codedom
3. 从图中生成一个新的源文件（示例在我提供的链接中）

编辑： 也许使用roslyn的Microsoft.CodeAnalysis（添加Microsoft.CodeAnalysis.CSharp nuget包）库更容易

var syntaxTree= CSharpSyntaxTree.ParseText(code);

//search for the methods and properties and add comments
// ** your code **
//

//getting the  new sourcecode
var root = (CompilationUnitSyntax)syntaxTree.GetRoot();
var mc= new ModelCollector();
mc.Visit(root);

string newCode = JsonConvert.SerializeObject(mc.models);

以下是创建新 cmets 的方法： https://docs.microsoft.com/en-us/dotnet/api/microsoft.codeanalysis.csharp.syntaxfactory.comment?view=roslyn-dotnet

lib 的完整文档： https://docs.microsoft.com/en-us/dotnet/api/microsoft.codeanalysis.csharp?view=roslyn-dotnet