docs: 补全 C# XML 文档注释,覆盖所有公开与内部成员
为 14 个项目中缺少 XML 注释的类、接口、方法、属性、字段、record、 枚举等成员补全中文文档注释。接口方法在接口层定义完整注释,实现类 使用 <inheritdoc /> 引用。私有辅助方法结合业务语义编写注释。 扫描结果:missing-csharp-docs.txt 缺失项归零。 构建结果:0 警告,0 错误。 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
@@ -37,6 +37,14 @@ namespace FileShare_Services.Core
|
||||
return Deserialize<T>(json, "query");
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 将 JSON 反序列化为目标类型,反序列化失败或结果为 null 时抛出 <see cref="ArgumentException"/>。
|
||||
/// </summary>
|
||||
/// <typeparam name="T">目标类型。</typeparam>
|
||||
/// <param name="json">JSON 字符串。</param>
|
||||
/// <param name="source">来源标识(body 或 query),用于异常消息。</param>
|
||||
/// <returns>反序列化后的实例。</returns>
|
||||
/// <exception cref="ArgumentException">JSON 无法绑定到目标类型时抛出。</exception>
|
||||
private static T Deserialize<T>(string json, string source)
|
||||
{
|
||||
try
|
||||
|
||||
Reference in New Issue
Block a user