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:
@@ -58,8 +58,18 @@ namespace FileShare_EFCore.Database
|
||||
=> new(DesignTimeDatabaseConfiguration.Create(args, DatabaseProvider.MySQL));
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 为设计时工具(dotnet ef migrations)提供数据库连接配置。
|
||||
/// </summary>
|
||||
internal static class DesignTimeDatabaseConfiguration
|
||||
{
|
||||
/// <summary>
|
||||
/// 解析命令行参数中的 --provider 选项,创建对应的 <see cref="DatabaseConfiguration"/>。
|
||||
/// 未指定提供程序时默认使用 SQLite。
|
||||
/// </summary>
|
||||
/// <param name="args">命令行参数。</param>
|
||||
/// <param name="defaultProvider">未指定时的默认数据库提供程序。</param>
|
||||
/// <returns>对应数据库提供程序的配置。</returns>
|
||||
public static DatabaseConfiguration Create(string[] args, DatabaseProvider defaultProvider = DatabaseProvider.SQLite)
|
||||
{
|
||||
DatabaseProviderRegistry.RegisterDefaults();
|
||||
@@ -75,6 +85,12 @@ namespace FileShare_EFCore.Database
|
||||
};
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 从命令行参数中解析 --provider 选项的值。
|
||||
/// 支持 <c>--provider sqlite</c> 和 <c>--provider=sqlite</c> 两种格式。
|
||||
/// </summary>
|
||||
/// <param name="args">命令行参数。</param>
|
||||
/// <returns>解析到的数据库提供程序,未指定或无法识别时返回 null。</returns>
|
||||
private static DatabaseProvider? GetProvider(string[] args)
|
||||
{
|
||||
for (var i = 0; i < args.Length; i++)
|
||||
|
||||
Reference in New Issue
Block a user