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

Question

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

我已经使用Visual Studio创建了一个新的类库项目，并且已经像下面这样修改了默认类的构造函数：

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做到。

Visual Studio c＃属性窗口没有用于指定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编译后，反编译后得到的是：

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

Answer 1

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

解决方法：

在VS2017中尝试使用ProduceReferenceAssembly。然后，您可以在ref文件夹中找到参考部件。 （或者您可以使用VS2019，此问题已在此处修复。）

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

[奇怪的是，当命令行运行时ProduceOnlyReferenceAssembly在VS中无法运行。我认为这可能是VS2017的问题，因此我建议您将此问题报告给DC forum。

（（我测试了该属性，发现它在VS2019中运行良好）。