程序集引用的“特定版本”属性在Visual Studio中的工作原理是什么？

Question

程序集引用的“特定版本”属性在Visual Studio中的工作原理是什么？今天，我仔细研究了Visual Studio 2010中程序集引用的“特定版本”属性。经过一些意外结果的实验后，我开始尽可能多地了解该属性的工作原理。即便如此，在我看来，并没有得到所有的答案，所以这是我尝试自我回答这个问题：如何准确地做在Visual Studio程序集引用作品的“特定版本”属性？

Answer 1

这是一个编译时的属性！

一要知道最重要的事情是，“特定版本”是，需要在效果的属性编译时和不运行时。

这是什么一回事呢？

构建项目时，需要解析项目的程序集引用，以便查找构建系统应使用的物理程序集。如果执行“特定版本”检查（请参阅“何时”特定版本“选中？”部分），则会影响装配解决过程的结果：

• 构建系统定位它可能使用的物理程序集

• 构建系统将物理程序集的版本与存储在.csproj文件中的程序集版本进行比较，以获得程序集引用

• 如果两个程序集版本完全相同，则解析过程成功，找到的物理程序集用于构建

• 如果两个组件版本不匹配，则丢弃物理组件，并通过定位下一个可能的组件继续解析过程

• 如果无法找到更多可能的物理组件，则解析过程将失败。这会导致编译器警告（警告MSB3245），告诉您无法解析引用。

• 有趣的是，构建然后继续！如果代码没有对程序集的实际引用，则构建成功（使用前面提到的警告）。如果代码具有引用，则构建将失败，并显示错误，该错误看起来好像代码使用的是未知类型或命名空间。构建真正失败的唯一迹象是警告MSB3245。

解决装配的顺序

程序集解析过程查找潜在程序集的顺序如下所示：

1. 由<HintPath>.csproj文件中的元素引用的程序集

2. 项目输出路径

3. GAC

请注意，如果GAC中存在多个版本的程序集，则解析过程首先尝试解析为具有最高版本的程序集。仅在未进行“特定版本”检查时，这一点很重要。

何时检查“特定版本”？

Visual Studio决定是否对.csproj文件中的两条信息执行“特定版本”检查：

• <SpecificVersion>元素的存在与否及其值（如果存在）

• 程序集引用中是否存在版本信息

这是带有版本信息的典型程序集引用的样子：

<Reference Include="Foo, Version=1.2.3.4, Culture=neutral, processorArchitecture=MSIL">
  <SpecificVersion>True</SpecificVersion>
  <HintPath>..\..\Bar\Foo.dll</HintPath></Reference>

这就是没有版本信息时程序集引用的样子：

<Reference Include="Foo">[...]

下表显示执行“特定版本”检查的时间，以及何时不执行。

                            |     Version information

                            |  Present       Not present

----------------------------+------------------------------

<SpecificVersion>           |

- Present, has value True   |    Yes (1)        Yes (check always fails) (2)

- Present, has value False  |    No  (3)        No (4)

- Not present               |    Yes (5)        No (6)

令人惊讶的是，如果<SpecificVersion>不存在和版本信息，则不执行检查（案例6）。我本以为要执行检查并且总是失败（与案例2相同），因为在我的理解中，缺少<SpecificVersion>意味着默认值“True”。这可能是Visual Studio 2010的一个怪癖，我在那里进行了测试。

在Visual Studio UI中检查程序集引用的属性（选择引用并按F4）时，您在“特定版本”属性中看到的值会告诉您Visual Studio是否要执行“特定版本”校验。在案例6中，UI将显示“True”，尽管该<SpecificVersion>元素不存在于.csproj文件中。

对“复制本地”的副作用

如果“复制本地”属性设置为“True”但由于“特定版本”检查而导致程序集解析过程失败，则不会复制任何程序集。

Answer 2

添加引用时，Visual Studio会在项目文件中记录程序集的[AssemblyVersion]。这个很重要。例如，如果您在一年后创建了一个错误修复程序，那么您需要确保使用完全相同的引用版本重新构建项目，这样才能真正实现这一目标。如果引用程序集已更改，您将收到错误。

但这并不总是令人满意的。一些程序员让程序集版本自动递增，每次重建时都会生成一个新版本。尽管程序集的公共接口从未改变过。有些人通过使用Nuget获取库来配置他们的项目，并在有新版本可用时让它自动更新库。他们希望将Specific Version属性设置为False以抑制编译错误。

了解后果非常重要，您需要重新部署整个程序版本以避免事故。运行时版本不匹配导致程序崩溃，只能使用<bindingRedirect>.config文件中的a进行抑制，这样做有风险。