如何使用 Visual Studio 2017 创建参考程序集

How to create a Reference Assembly with Visual Studio 2017

我正在尝试使用 Visual Studio 2017 而不是命令行创建参考程序集。

我使用 Visual Studio 2017 创建了一个新的 class 库项目,并且我修改了默认 class 的构造函数,如下所示:

using System;

namespace ReferenceAssembly
{
    public class Class1
    {
        public Class1()
        {
            throw new Exception("Hello World");
        }
    }
}

因为我想要一个参考程序集,所以我希望构造函数的实现像 throw null 而不是 throw new Exception("Hello World");

如果我从命令行编译项目:

csc.exe /target:library /refonly /out:referenceAssembly.dll Class1.cs

...一切正常:如果我反编译程序集,我得到的是预期的结果:

public Class1()
{
    throw null;
}

现在我想在 Visual Studio 2017 年完成。

Visual Studio 2017 c# 属性 window 没有任何标志来指定 refonly 标志,所以我决定编辑.csproj 文件在每个 PropertyGroup 节点中添加 <ProduceOnlyReferenceAssembly>true</ProduceOnlyReferenceAssembly>

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <Import Project="$(MSBuildExtensionsPath)$(MSBuildToolsVersion)\Microsoft.Common.props" Condition="Exists('$(MSBuildExtensionsPath)$(MSBuildToolsVersion)\Microsoft.Common.props')" />
  <PropertyGroup>
    <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
    <ProduceOnlyReferenceAssembly>true</ProduceOnlyReferenceAssembly>
    <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
    <ProjectGuid>3be579e4-9fde-4fd1-867c-ac5cd0411b65</ProjectGuid>
    <OutputType>Library</OutputType>
    <AppDesignerFolder>Properties</AppDesignerFolder>
    <RootNamespace>ReferenceAssembly</RootNamespace>
    <AssemblyName>ReferenceAssembly</AssemblyName>
    <TargetFrameworkVersion>v4.6</TargetFrameworkVersion>
    <FileAlignment>512</FileAlignment>
    <Deterministic>true</Deterministic>
  </PropertyGroup>
  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
    <ProduceOnlyReferenceAssembly>true</ProduceOnlyReferenceAssembly>
    <DebugSymbols>true</DebugSymbols>
    <DebugType>full</DebugType>
    <Optimize>false</Optimize>
    <OutputPath>bin\Debug\</OutputPath>
    <DefineConstants>DEBUG;TRACE</DefineConstants>
    <ErrorReport>prompt</ErrorReport>
    <WarningLevel>4</WarningLevel>
  </PropertyGroup>
  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
    <ProduceOnlyReferenceAssembly>true</ProduceOnlyReferenceAssembly>
    <DebugType>pdbonly</DebugType>
    <Optimize>true</Optimize>
    <OutputPath>bin\Release\</OutputPath>
    <DefineConstants>TRACE</DefineConstants>
    <ErrorReport>prompt</ErrorReport>
    <WarningLevel>4</WarningLevel>
  </PropertyGroup>
  <ItemGroup>
    <Reference Include="System"/>
    <Reference Include="System.Core"/>
    <Reference Include="System.Xml.Linq"/>
    <Reference Include="System.Data.DataSetExtensions"/>
    <Reference Include="Microsoft.CSharp"/>
    <Reference Include="System.Data"/>
    <Reference Include="System.Net.Http"/>
    <Reference Include="System.Xml"/>
  </ItemGroup>
  <ItemGroup>
    <Compile Include="Class1.cs" />
    <Compile Include="Properties\AssemblyInfo.cs" />
  </ItemGroup>
  <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />
 </Project>

但是用Visual Studio 2017编译后反编译得到的是:

public Class1()
{
    throw new Exception("Hello World");
}

How to create a Reference Assembly with Visual Studio

解决方法:

在 VS2017 中尝试使用 ProduceReferenceAssembly。然后你可以在 ref 文件夹中找到参考程序集。 (或者你可以使用 VS2019,此问题已在那里修复。)

根据this documentProduceOnlyReferenceAssembly是一个布尔值,它指示编译器只发出一个参考程序集而不是编译后的代码。此 属性 对应于 vbc.exe and csc.exe 编译器的 /refonly 开关。

奇怪的是,ProduceOnlyReferenceAssembly 在 VS 中无法工作,而命令行工作。我认为这可能是 VS2017 的一个问题,所以我建议您将此问题报告给 DC forum

(我测试了 属性,发现它在 VS2019 中运行良好)。