From a7617c35e1698e2d9c691d072f94522ace1a7d49 Mon Sep 17 00:00:00 2001
From: Falcon <12919280+falconfly@user.noreply.gitee.com>
Date: Wed, 12 Feb 2025 15:54:57 +0800
Subject: [PATCH] =?UTF-8?q?=E5=8D=87=E7=BA=A72.13.0=20=E6=96=B0=E5=A2=9E?=
 =?UTF-8?q?=E6=94=AF=E6=8C=81=E4=BB=8Exml=E6=96=87=E4=BB=B6=E4=B8=AD?=
 =?UTF-8?q?=E8=8E=B7=E5=8F=96Type=E5=92=8C=E5=B1=9E=E6=80=A7=E7=9A=84summa?=
 =?UTF-8?q?ry=E3=80=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Falcon.SugarApi/Falcon.SugarApi.csproj |  2 +-
 Falcon.SugarApi/TypeExtend.cs          | 66 +++++++++++++++++++++++++-
 2 files changed, 65 insertions(+), 3 deletions(-)

diff --git a/Falcon.SugarApi/Falcon.SugarApi.csproj b/Falcon.SugarApi/Falcon.SugarApi.csproj
index 344fdfc..199e672 100644
--- a/Falcon.SugarApi/Falcon.SugarApi.csproj
+++ b/Falcon.SugarApi/Falcon.SugarApi.csproj
@@ -8,7 +8,7 @@
 		<DocumentationFile>bin\$(Configuration)\$(TargetFramework)\$(AssemblyName).xml</DocumentationFile>
 		<GenerateDocumentationFile>true</GenerateDocumentationFile>
 		<GeneratePackageOnBuild>true</GeneratePackageOnBuild>
-		<Version>2.12.0</Version>
+		<Version>2.13.0</Version>
 	</PropertyGroup>
 
 	<ItemGroup>
diff --git a/Falcon.SugarApi/TypeExtend.cs b/Falcon.SugarApi/TypeExtend.cs
index a0d4f94..9d261be 100644
--- a/Falcon.SugarApi/TypeExtend.cs
+++ b/Falcon.SugarApi/TypeExtend.cs
@@ -1,6 +1,9 @@
 using System;
 using System.Diagnostics.CodeAnalysis;
+using System.IO;
+using System.Linq;
 using System.Reflection;
+using System.Xml.Linq;
 
 namespace Falcon.SugarApi
 {
@@ -17,7 +20,7 @@ namespace Falcon.SugarApi
         /// <param name="info">属性</param>
         /// <param name="p">定义的特性</param>
         /// <returns>定义返回True，否则False</returns>
-        public static bool TryGetAttribute<T>([NotNull] this PropertyInfo info, out T p) where T : Attribute {
+        public static bool TryGetAttribute<T>([NotNull] this PropertyInfo info,out T p) where T : Attribute {
             p = info.GetCustomAttribute<T>();
             return p != null;
         }
@@ -29,9 +32,68 @@ namespace Falcon.SugarApi
         /// <param name="info">属性</param>
         /// <param name="p">定义的特性</param>
         /// <returns>定义返回True，否则False</returns>
-        public static bool TryGetAttribute<T>([NotNull] this Type info, out T p) where T : Attribute {
+        public static bool TryGetAttribute<T>([NotNull] this Type info,out T p) where T : Attribute {
             p = info.GetCustomAttribute<T>();
             return p != null;
         }
+
+        /// <summary>
+        /// 获取类型的summary说明
+        /// </summary>
+        /// <param name="type">类型</param>
+        /// <returns>summary值，没有返回空字符串</returns>
+        /// <exception cref="ArgumentNullException"></exception>
+        public static string? GetTypeSummary(this Type type) {
+            _ = type ?? throw new ArgumentNullException(nameof(type));
+            var assemblyName = type.Assembly.FullName;
+            if(assemblyName == null) {
+                return "";
+            }
+            var dllLocal = type.Assembly.Location;
+            var xmlLocal = $"{dllLocal.Substring(0,dllLocal.Length - 3)}xml";
+            if(!File.Exists(xmlLocal)) {
+                return "";
+            }
+            var xdoc = XDocument.Load(xmlLocal);
+            if(xdoc == null) {
+                return "";
+            }
+            var members = xdoc.Descendants("member");
+            var find = members.Where(a => a.Attribute("name")?.Value == $"T:{type.FullName}");
+            if(find.Any()) {
+                return find.First().Element("summary")?.Value?.Trim() ?? "";
+            }
+            return "";
+        }
+
+        /// <summary>
+        /// 获取属性的summary说明
+        /// </summary>
+        /// <param name="property">属性</param>
+        /// <returns>summary值，没有返回空字符串</returns>
+        /// <exception cref="ArgumentNullException"></exception>
+        public static string GetPropertySummary(this PropertyInfo property) {
+            _ = property ?? throw new ArgumentNullException(nameof(property));
+            var type = property.ReflectedType;
+            if(type == null) {
+                return "";
+            }
+            var dllLocal = type.Assembly.Location;
+            var xmlLocal = $"{dllLocal.Substring(0,dllLocal.Length - 3)}xml";
+            if(!File.Exists(xmlLocal)) {
+                return "";
+            }
+            var xdoc = XDocument.Load(xmlLocal);
+            if(xdoc == null) {
+                return "";
+            }
+            var members = xdoc.Descendants("member");
+            var find = members.Where(a => a.Attribute("name")?.Value == $"P:{type.FullName}.{property.Name}");
+            if(find.Any()) {
+                return find.First().Element("summary")?.Value?.Trim() ?? "";
+            }
+            return "";
+        }
+
     }
 }