特定版本(Specific Version)属性
一、设置特定版本属性
二、属性说明
1.“特定版本”这个属性仅在编译时有效,在程序运行时,不发挥作用。
2.编译项目时,需要解析项目的程序集引用,以便找到编译时应使用的物理程序集(.dll文件)。
如果“特定版本”被设置为true,它会影响程序集解析过程,执行如下特定版本信息的检查(假设引用中存在版本信息):
(1)编译系统定位它可能使用的所有物理程序集
(2)编译系统比较“具体的物理程序集的版本”与“ .csproj 文件中存储的程序集版本”,以确定是否使用这个物理程序集:
如果两个程序集版本完全相同,则解析过程成功,找到了用于编译的物理程序集;
如果两个程序集版本不匹配,则丢弃这个物理程序集。
解析过程继续进行(编译系统定位到下一个候选的物理程序集);
(3)如果找不到更多候选的物理程序集,则解析过程失败。
这会导致编译器发出警告(警告 MSB3245),告诉您无法解析引用。
有趣的是,编译工作仍然会继续下去!如果代码没有对程序集的实际引用,则编译成功(带有前面提到的警告)。如果代码里有引用,则编译失败并显示错误,告诉您代码使用了未知类型或命名空间。
3.编译系统解析物理程序集的顺序
(1).csproj 文件中 <HintPath> 元素指定的
(2)项目输出路径(/Debug目录)
(3)GAC
请注意,在“特定版本”为false时,如果 GAC 中存在多个版本的程序集,则解析过程首先尝试解析具有最高版本的程序集。
4.编译时是否执行引用的特定版本检查,依据2个来自.csproj文件的信息:
- 是否存在
<SpecificVersion>
标签,以及它的值 (如果标签存在) - 引用标签<Reference>是否含有版本信息
以下例子,既有<SpecificVersion>
标签和它的值 True ,也有版本信息:Version=1.2.3.4
<Reference Include="Foo, Version=1.2.3.4, Culture=neutral, processorArchitecture=MSIL"> <SpecificVersion>True</SpecificVersion> <HintPath>..\..\Bar\Foo.dll</HintPath> </Reference>
编译时是否执行引用的特定版本检查的回答,如下表:
5.对“复制本地”的影响
如果“复制本地(Copy Local)”属性设置为“True”,但程序集解析过程因“特定版本”检查而失败,则不会复制任何程序集到输出目录(/Debug)。
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 没有源码,如何修改代码逻辑?
· 一个奇形怪状的面试题:Bean中的CHM要不要加volatile?
· [.NET]调用本地 Deepseek 模型
· 一个费力不讨好的项目,让我损失了近一半的绩效!
· .NET Core 托管堆内存泄露/CPU异常的常见思路
· 微软正式发布.NET 10 Preview 1:开启下一代开发框架新篇章
· DeepSeek “源神”启动!「GitHub 热点速览」
· C# 集成 DeepSeek 模型实现 AI 私有化(本地部署与 API 调用教程)
· DeepSeek R1 简明指南:架构、训练、本地部署及硬件要求
· NetPad:一个.NET开源、跨平台的C#编辑器