From adc38cc4f0953f5593c4c95681b73625bf15d66e Mon Sep 17 00:00:00 2001
From: GeWuYou <95328647+GeWuYou@users.noreply.github.com>
Date: Sat, 18 Apr 2026 21:39:19 +0800
Subject: [PATCH] =?UTF-8?q?docs(logging):=20=E6=9B=B4=E6=96=B0=E6=97=A5?=
 =?UTF-8?q?=E5=BF=97=E5=B7=A5=E5=8E=82=E6=96=B9=E6=B3=95=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 为 ConfigurableLoggerFactory.GetLogger 方法添加 ArgumentNullException 异常说明
- 补充了当 name 参数为 null 时的异常抛出情况
- 完善了方法的 XML 注释文档
---
 GFramework.Core/Logging/ConfigurableLoggerFactory.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/GFramework.Core/Logging/ConfigurableLoggerFactory.cs b/GFramework.Core/Logging/ConfigurableLoggerFactory.cs
index 4d1fd064..c42b5e61 100644
--- a/GFramework.Core/Logging/ConfigurableLoggerFactory.cs
+++ b/GFramework.Core/Logging/ConfigurableLoggerFactory.cs
@@ -29,7 +29,8 @@ internal sealed class ConfigurableLoggerFactory : ILoggerFactory, IDisposable
         // 外部配置可能把集合项反序列化为 null，这里先给出可诊断异常，避免后续工厂链路出现不清晰的空引用失败。
         _appenders = _config.Appenders
             .Select(static appenderConfig => appenderConfig ??
-                throw new InvalidOperationException("Appender configuration cannot be null."))
+                                             throw new InvalidOperationException(
+                                                 "Appender configuration cannot be null."))
             .Select(LoggingConfigurationLoader.CreateAppender)
             .ToArray();
     }
@@ -64,6 +65,7 @@ internal sealed class ConfigurableLoggerFactory : ILoggerFactory, IDisposable
     /// <param name="name">日志记录器名称。</param>
     /// <param name="minLevel">调用方要求的最小日志级别下限；在未命中命名空间覆盖时生效。</param>
     /// <returns>可写入日志的记录器实例。</returns>
+    /// <exception cref="ArgumentNullException"><paramref name="name"/> 为 <see langword="null" />。</exception>
     /// <remarks>
     ///     当配置文件与调用方同时提供默认级别时，会取两者中更严格的那一个；
     ///     若命中更具体的命名空间级别覆盖，则以该覆盖配置为准，即使其低于调用方传入的默认下限。