C# DLL项目编译出现MSB3061警告的原因及非抑制解决咨询

构建C# DLL类库项目时，编译流程已成功生成DLL并完成注册表注册，但抛出MSB3061警告：

C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Current\Bin\amd64\Microsoft.Common.CurrentVersion.targets(5823,5): warning MSB3061: 无法删除文件“C:\Users\Madhu\Documents\repos\MyCtrl\bin\Debug\MyCtrl.dll”。对路径“C:\Users\Madhu\Documents\repos\MyCtrl\bin\Debug\MyCtrl.dll”的访问被拒绝。

环境与已尝试操作 #

• 系统：Windows 10
• 开发工具：Visual Studio Professional 2022（64位）17.11.5版本
• 已尝试：以管理员模式运行VS，确保普通用户及管理员账户对bin目录及其子文件夹拥有写入/修改权限

注册相关代码实现 #

项目中[ComRegisterFunction()]标记的注册方法及逻辑如下：

// [ComRegisterFunction()] 标记的Register方法
public static void Register(Type t) { 
  try { 
    if (OperatingSystem.IsWindows()) { 
      ActiveXCtrlHelper.RegasmRegisterControl(t); 
    } 
  } 
  catch (Exception ex) { 
    throw; 
  } 
} 

// RegasmRegisterControl方法实现
public static void RegasmRegisterControl(Type t)
{
    // 检查参数
    GuardNullType(t, "t");
    GuardTypeIsControl(t);

    // 打开控件的CLSID注册表项
    using (RegistryKey keyCLSID = Registry.ClassesRoot.OpenSubKey(
        @"CLSID\" + t.GUID.ToString("B"), true))
    {
        RegistryKey subkey = null;
        subkey = keyCLSID.OpenSubKey("InprocServer32", true);
        if (subkey != null)
        {
            try
            {
                string strAssemblyPath = IsNetCore() ? GetLatestNetCoreRuntimePath() + @"\coreclr.dll" : Environment.SystemDirectory + @"\mscoree.dll";
                if (System.IO.File.Exists(strAssemblyPath))
                {
                    subkey.SetValue(null, strAssemblyPath);
                }
            }
            catch (Exception) {}
        }

        using (subkey = keyCLSID.CreateSubKey("Control")) {; };

        using (subkey = keyCLSID.CreateSubKey("MiscStatus"))
        {
            int nMiscStatus = OLEMISC_RECOMPOSEONRESIZE +
                OLEMISC_CANTLINKINSIDE + OLEMISC_INSIDEOUT +
                OLEMISC_ACTIVATEWHENVISIBLE + OLEMISC_SETCLIENTSITEFIRST;
            subkey.SetValue("", nMiscStatus.ToString(), RegistryValueKind.String);
        }

        using (subkey = keyCLSID.CreateSubKey("ToolBoxBitmap32"))
        {
            subkey.SetValue("", Assembly.GetExecutingAssembly().Location + ", 101",
                RegistryValueKind.String);
        }

        using (subkey = keyCLSID.CreateSubKey("TypeLib"))
        {
            Guid libId = AssemblyExtenstions.GetTypeLibGuidForAssembly(t.Assembly);
            subkey.SetValue("", libId.ToString("B"), RegistryValueKind.String);
        }

        using (subkey = keyCLSID.CreateSubKey("Version"))
        {
            int nMajor, nMinor;
            AssemblyExtenstions.GetTypeLibVersionForAssembly(t.Assembly, out nMajor, out nMinor);
            subkey.SetValue("", String.Format("{0}.{1}", nMajor, nMinor));
        }

    }
}

注：由于.NET Core中GetTypeLibVersionForAssembly()和GetTypeLibGuidForAssembly()不可用，已通过自定义扩展函数，基于GuidAttribute和AssemblyVersionAttribute实现对应功能。

MSB3061警告的核心是DLL文件在构建/注册流程中被占用，导致后续清理操作无法删除旧文件，具体触发场景包括：

1. 注册逻辑锁定DLL：代码中Assembly.GetExecutingAssembly().Location会将当前DLL加载到内存，CLR在注册过程中可能保持文件句柄锁定，导致后续构建流程无法覆盖旧文件。
2. COM注册进程残留：COM注册操作可能导致系统服务（如dllhost.exe）或相关进程未及时释放DLL文件句柄。
3. 构建时序冲突：VS内置的COM注册步骤执行时机过早，DLL未完全释放就触发了后续的文件清理/覆盖操作。

方法1：修改注册逻辑，避免加载当前DLL #

替换Assembly.GetExecutingAssembly().Location的调用方式，避免运行时加载DLL导致锁定：

// 替换ToolBoxBitmap32的赋值代码，使用项目输出路径（可通过MSBuild变量$(TargetPath)传递）
string assemblyPath = Path.Combine(AppContext.BaseDirectory, "MyCtrl.dll");
subkey.SetValue("", assemblyPath + ", 101", RegistryValueKind.String);

或通过AssemblyName获取路径而不加载完整程序集：

AssemblyName assemblyName = AssemblyName.GetAssemblyName(t.Assembly.Location);
string assemblyPath = new Uri(assemblyName.CodeBase).LocalPath;

方法2：调整构建流程的注册时机 #

将COM注册步骤延迟到构建完成后执行，避开VS内置流程的锁定：

1. 右键项目 → 属性 → 生成事件 → 后期生成事件命令行，添加注册命令：

regasm "$(TargetPath)" /codebase /tlb

2. 关闭项目属性中的「为COM互操作注册」选项，取消VS内置的提前注册逻辑。

方法3：使用AssemblyLoadContext主动卸载（仅.NET Core/.NET 5+） #

通过可回收的AssemblyLoadContext加载DLL，注册完成后主动卸载释放文件句柄：

// 在Register方法中调整加载方式
var alc = new AssemblyLoadContext(null, isCollectible: true);
Assembly assembly = alc.LoadFromAssemblyPath(t.Assembly.Location);
// 执行注册逻辑（需基于加载的assembly获取类型）
alc.Unload();

方法4：构建前终止占用进程 #

添加预生成事件，终止可能占用DLL的进程：

taskkill /f /im dllhost.exe /fi "MODULES eq MyCtrl.dll" 2>nul

注：若VS进程本身占用DLL，可添加taskkill /f /im devenv.exe /fi "MODULES eq MyCtrl.dll" 2>nul，但会重启VS，适合自动化构建场景。

内容的提问来源于stack exchange，提问作者Madhu