Question

我正在使用SyntaxRewriter将类从旧库转换为新库，这基本上需要查找给定属性的类，然后重写遵循特定约定的属性。重写器的一般骨架如下：

class PropertyConverter : SyntaxRewriter
{
    public override SyntaxNode VisitPropertyDeclaration(PropertyDeclarationSyntax node)
    {
        if (!MeetsUpdateCriteria(node)) return base.VisitPropertyDeclaration(node);

        // these implementations simply return a string
        var name = FigureOutName(node.Identifier);
        var propertyType = FigureOutType(node.Type);

        var getter = Syntax.ParseExpression("this.GetValue<" + propertyType + ">(" + name + ")");
        var setter = Syntax.ParseExpression("this.SetValue(" + name + ", value)");

        return node.WithType(propertyType)
                   .WithAccessorList(
            Syntax.AccessorList(Syntax.List(
                Syntax.AccessorDeclaration(
                    SyntaxKind.GetAccessorDeclaration,
                    Syntax.Block(Syntax.ReturnStatement(getter))),
                Syntax.AccessorDeclaration(
                    SyntaxKind.SetAccessorDeclaration,
                    Syntax.Block(Syntax.ExpressionStatement(setter)))))));
    }
}

此转换器的结果是具有更新属性的类，并使用以下代码输出：

// IDocument csfile <- from a project in a Workspace
var tree = csfile.GetSyntaxTree();
var root = new PropertyConverter().Visit((SyntaxNode)tree.GetRoot())
                                  .NormalizeWhitespace(); // problem!

File.WriteAllText(Path.GetFileName(csfile.FilePath), root.ToFullString());

此时代码在语法上都是正确的，并且输出的语法树是正确的。我唯一的抱怨是XML文档注释周围的空白是不正确的：

/// <summary>
        /// Gets or sets the thickness (TH).
        /// </summary>
public float Thickness
{
    get
    {
        return this.GetValue<float>(TH);
    }

    set
    {
        this.SetValue(TH, value);
    }
}

注意所有无关的缩进。此外，间距也以其他方式被破坏，尤其是方法文档：

/// <summary>
        /// Initializes a new instance of the <see cref = "X"/> class.
        /// </summary>
        /// <param name = "innerRadius">Inner radius of the X.</param>
        /// <param name = "thickness">Thickness of the X.</param>

我已经验证输入树没有遭受这些缩进问题，并且我还验证了在调用NormalizeWhitespace之前树没有遭受这些缩进问题。我也试过elasticTrivia: true，但也没有运气。

那么如何让Roslyn以一致的方式规范空白？

Answer 1

我认为这可能是罗斯林的一个错误。但是，一般情况下，我建议在Roslyn.Services.dll中包含的SyntaxNode上使用Format扩展方法（添加using Roslyn.Services;）。

NormalizeWhitespace是一个非常强力的系统，主要用于确保代码往返。 Roslyn.Services层中存在的格式代码更灵活，并且包含了Visual Studio Format Document命令的许多行为。

如何让Roslyn正确格式化XML文档注释？

1 个答案: