使用Wesky.Net.Opentools库，一行代码实现自动解析实体类summary注释信息（可用于数据实体文档的快速实现）

使用前，需要对你的项目勾选输出api文档文件。

引用Wesky.Net.OpenTools包，保持1.0.11版本或以上。

为了方便，我直接在昨天的演示基础上，继续给实体类添加注释。

昨天的演示文章可参考：

C#/.NET一行代码把实体类类型转换为Json数据字符串

https://mp.weixin.qq.com/s/nVcURD0lf5-AQOVzwHqcxw

对实体类添加注释：

然后传入实体类型，即可获取到类型数据集合：

运行一下看下效果：

以上只是简单演示，你也可以用来快速生成实体类说明文档。例如通过反射，获取所有类型，然后进行代入，解析出每个类型里面的属性以及注释，直接就是你的一个演示文档了。

解析部分核心代码：

  /// 
  /// 生成给定类型的所有属性的摘要信息列表，搜索所有相关XML文档。
  /// Generates a list of summary information for all properties of a given type, searching through all relevant XML documents.
  /// 
  /// 要分析的类型。The type to analyze.
  /// 处理属性路径时用于嵌套属性的前缀。Prefix for nested properties to handle property paths correctly.
  /// 摘要信息实体列表。A list of summary information entities.
  public static List GenerateEntitySummaries(Type type, string parentPrefix = "")
  {
      var summaryInfos = new List();
      IEnumerable<string> xmlPaths = GetAllXmlDocumentationPaths();

      foreach (string xmlPath in xmlPaths)
      {
          if (File.Exists(xmlPath))
          {
              XDocument xmlDoc = XDocument.Load(xmlPath);
              XElement root = xmlDoc.Root;

              summaryInfos.AddRange(ExtractSummaryInfo(type, root, parentPrefix));
          }
      }

      return summaryInfos;
  }

  /// 
  /// 获取当前执行环境目录下所有XML文档的路径。
  /// Retrieves the paths to all XML documentation files in the current execution environment directory.
  /// 
  /// 所有XML文档文件的路径列表。A list of paths to all XML documentation files.
  private static IEnumerable<string> GetAllXmlDocumentationPaths()
  {
      string basePath = AppContext.BaseDirectory;
      return Directory.GetFiles(basePath, "*.xml", SearchOption.TopDirectoryOnly);
  }

  /// 
  /// 从XML文档中提取指定类型的所有属性的摘要信息。
  /// Extracts summary information for all properties of a specified type from an XML document.
  /// 
  /// 属性所属的类型。The type to which the properties belong.
  /// XML文档的根元素。The root element of the XML document.
  /// 属性的前缀路径。The prefix path for properties.
  /// 摘要信息实体列表。A list of summary information entities.
  private static List ExtractSummaryInfo(Type type, XElement root, string parentPrefix)
  {
      var infos = new List();

      foreach (PropertyInfo property in type.GetProperties())
      {
          string fullPath = string.IsNullOrEmpty(parentPrefix) ? property.Name : $"{parentPrefix}.{property.Name}";
          string typeName = property.PropertyType.Name;

          if (property.PropertyType.IsClass && property.PropertyType != typeof(string))
          {
              Type propertyType = property.PropertyType;
              if (propertyType.IsGenericType && propertyType.GetGenericTypeDefinition() == typeof(List<>))
              {
                  propertyType = propertyType.GetGenericArguments()[0];
                  typeName = $"List<{propertyType.Name}>";
              }

              infos.AddRange(GenerateEntitySummaries(propertyType, fullPath));
          }
          else
          {
              string summary = GetPropertySummary(root, type, property);
              infos.Add(new DynamicSumaryInfo
              {
                  Name = fullPath,
                  TypeName = typeName,
                  Summary = summary ?? string.Empty
              });
          }
      }

      return infos;
  }