如何扩展Visual Studio类图功能以支持DynamicData库中SourceList类的自定义集合关联识别？

问题描述 #

我有两个数据类：

public class Comment { public string Message { get; set; } }

public class Topic { 
    public string Title { get; set; } 
    public DateTime CreationDate { get; set; } 
    public SourceList<Comment> Comments { get; set; } 
}

Topic类里的Comments是DynamicData库的SourceList<T>类型，这个集合没有直接暴露项，而是通过Items属性提供IEnumerable<T>内容。现在Visual Studio的类图没法自动识别Topic和Comment之间的关联关系，请问有没有办法扩展类图功能来支持这种自定义集合？

解决方案 #

1. 用[Association]特性手动声明关联

Visual Studio类图支持通过System.ComponentModel.DataAnnotations.Schema.AssociationAttribute显式指定类间关联，不管集合是不是自定义类型。给Comments属性加上这个特性，明确关联关系：

using System.ComponentModel.DataAnnotations.Schema;

public class Topic { 
    public string Title { get; set; } 
    public DateTime CreationDate { get; set; } 
    // 如果你的类有主键，可以指定关联的键对；没有的话只填关联名称即可
    [Association("Topic_Has_Comments")]
    public SourceList<Comment> Comments { get; set; } 
}

添加后，类图就能识别出Topic和Comment的一对多关联了。

2. 添加一个仅用于类图的包装属性

你可以在Topic里加一个只读的IEnumerable<Comment>属性，指向SourceList的Items，同时用[Browsable(false)]让它不在属性窗口显示，但类图能检测到：

using System.ComponentModel;
using System.Linq;

public class Topic { 
    public string Title { get; set; } 
    public DateTime CreationDate { get; set; } 
    public SourceList<Comment> Comments { get; set; } 

    // 仅用于类图识别，不影响业务逻辑
    [Browsable(false)]
    public IEnumerable<Comment> CommentsForClassDiagram => Comments?.Items ?? Enumerable.Empty<Comment>();
}

这个方法简单且不改动原有集合的使用方式，类图会自动把这个属性识别为集合关联。

3. 自定义Visual Studio类图扩展（进阶）

如果上面的方法都不够，你可以基于Visual Studio SDK开发自定义扩展：

• 实现自定义的类型发现服务，让它能解析SourceList<T>的泛型参数，自动生成关联
• 或者编写类图的自定义解析器，专门处理SourceList<T>类型的属性

不过这种方法需要熟悉VS扩展开发，适合需要大量使用自定义集合的场景，开发成本相对高一些。

4. 临时替换为标准集合（快速应急）

如果只是临时需要生成正确的类图，可以先把SourceList<Comment>换成List<Comment>，生成类图后再改回SourceList。这是最快捷的临时方案，但没法永久解决问题。

内容的提问来源于stack exchange，提问作者Amir Mahdi Nassiri