牛啊后续：如何一行C#代码实现解析类型的Summary注释(可用于数据字典快速生成)...

前言：下午有小伙伴要求，让我继续做个解析实体类注释信息的内容。所以我也顺便加入进来。以下开始正文实战操作：

项目需要勾选输出api文档文件。这样就可以让所有实体类的summary信息被写入到输出目录下。如果有多个xml文件也没关系，下面的包已经实现自动解析多个xml文件功能，只选取匹配的那个。

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

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

昨天的演示文章可参考：

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

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

对实体类添加注释，该实体类嵌套一层集合属性。

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

运行一下看下效果：

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

解析部分核心代码：

/// <summary>/// 生成给定类型的所有属性的摘要信息列表，搜索所有相关XML文档。/// Generates a list of summary information for all properties of a given type, searching through all relevant XML documents./// </summary>/// <param name="type">要分析的类型。The type to analyze.</param>/// <param name="parentPrefix">处理属性路径时用于嵌套属性的前缀。Prefix for nested properties to handle property paths correctly.</param>/// <returns>摘要信息实体列表。A list of summary information entities.</returns>public static List<DynamicSumaryInfo> GenerateEntitySummaries(Type type, string parentPrefix = ""){var summaryInfos = new List<DynamicSumaryInfo>();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;}/// <summary>/// 获取当前执行环境目录下所有XML文档的路径。/// Retrieves the paths to all XML documentation files in the current execution environment directory./// </summary>/// <returns>所有XML文档文件的路径列表。A list of paths to all XML documentation files.</returns>private static IEnumerable<string> GetAllXmlDocumentationPaths(){string basePath = AppContext.BaseDirectory;return Directory.GetFiles(basePath, "*.xml", SearchOption.TopDirectoryOnly);}/// <summary>/// 从XML文档中提取指定类型的所有属性的摘要信息。/// Extracts summary information for all properties of a specified type from an XML document./// </summary>/// <param name="type">属性所属的类型。The type to which the properties belong.</param>/// <param name="root">XML文档的根元素。The root element of the XML document.</param>/// <param name="parentPrefix">属性的前缀路径。The prefix path for properties.</param>/// <returns>摘要信息实体列表。A list of summary information entities.</returns>private static List<DynamicSumaryInfo> ExtractSummaryInfo(Type type, XElement root, string parentPrefix){var infos = new List<DynamicSumaryInfo>();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;}

如果以上内容对你有帮助，欢迎点赞、留言、在看、转发，也欢迎关注我的个人公众号：【Dotnet Dancer】

快捷关注：