.Csproj文件学习笔记

Visual Studio现在使用.csproj文件来管理项目。我们可以通过右键单击项目并选择Edit <project-name> .csproj来编辑.csproj设置，如下所示。

上面项目的.csproj如下所示。

csproj文件包括与目标.NET Framework，项目文件夹，NuGet程序包引用等相关的设置。

.csproj是基于XML的格式。以下示例显示了使用.NET Core项目的根节点Microsoft.NET.Sdk。对于Web项目，使用的SDK是Microsoft.NET.Sdk.Web。

<Project Sdk="Microsoft.NET.Sdk">
...
</Project>

我们可以自己直接编辑.csproj文件，并手动添加必要的项目。所需的确切代码取决于需要链接的文件类型以及所需的MSBuild操作类型。

例如，如果我们要通过链接从项目外部添加.cs文件，则可以使用嵌套在<ItemGroup>中的元素<compile>：

<ItemGroup>
  <Compile Include="..OtherFolderMySharedClass.cs" Link="MySharedClass.cs" />
</ItemGroup>

Include给出项目文件夹中文件的相对路径，Link属性告诉MSBuild将文件添加为链接，以及应该用于该文件的名称。甚至还可以更改文件名。

对于诸如JSON配置文件之类的内容文件，我们可以使用<content>元素，例如：

<ItemGroup>
  <Content Include="..SharedSharedSettings.json" Link="SharedSettings.json" CopyToOutputDirectory="PreserveNewest" />
</ItemGroup>

在此示例中，我们将CopyToOutputDirectory设置为PreserveNewest，以便在构建或发布项目时将文件复制到输出目录。

PackageReference元素指定项目的NuGet依赖。Include属性指定包ID

<PackageReference Include="package-id" Version="" PrivateAssets="" IncludeAssets="" ExcludeAssets="" />

Version属性指定要还原的软件包的版本。

IncludeAssets属性指定<PackageReference>应使用属于指定包的哪些资产。默认情况下，包括所有包装资产。

ExcludeAssets属性指定<PackageReference>不应消耗属于指定包的资产。

PrivateAssets属性指定<PackageReference>应使用属于指定包的哪些资产，但不应流到下一个项目。的Analyzers，Build和ContentFiles资产都默认为私享此属性不存在。

多个目标框架

我们可以创建.NET Core应用程序并为其配置多个目标框架，以便它可以与所有已配置的目标框架一起运行。要定位多个框架，需要更改<TargetFramework>为复数，<TargetFrameworks>并包含我们要定位的不同框架的别名，并用;分隔：

<PropertyGroup>
   <TargetFrameworks>netstandard2.0;net462</TargetFrameworks>
 </PropertyGroup>

条件引用

我们可能会遇到的一个问题是，需要根据要构建的目标引用不同的程序集或NuGet程序包。

例如，我们将以下方法添加到我们的库中，它将成功编译.NET Standard 2.0目标，但是.NET 4.6.2目标将失败，因为它找不到.NET的定义HttpUtility。

public string JavaScriptEncode(string input)
{
    return HttpUtility.JavaScriptStringEncode(input);
}

要解决此问题，我们需要添加对System.Web程序集的引用，但仅.NET 4.6.2目标需要它。为此，我们只需.csproj使用以下语法在文件中添加条件引用即可：

<ItemGroup Condition=" '$(TargetFramework)' == 'net462' ">
    <Reference Include="System.Web" />
</ItemGroup>

如果要有条件引用的NuGet程序包，则使用PackageReference。可以使用多个条件：

<ItemGroup Condition=" '$(TargetFramework)' == 'net462' or '$(TargetFramework)' == 'net35'">
    <PackageReference Include="NAudio" Version="1.8.5" />
</ItemGroup>

条件编译

有时我们可能想从某些目标的编译中排除某些C＃文件。例如，以下是在NAudio中针对.NET 3.5目标的方法，我引用了System.Windows.Forms程序集，并从编译中排除了三个特定文件：

<ItemGroup Condition=" '$(TargetFramework)' == 'net35' ">
   <Reference Include="System.Windows.Forms" />
   <Compile Remove="WaveWaveOutputsWasapiOutRT.cs" />
   <Compile Remove="WaveWaveInputsWasapiCaptureRT.cs" />
   <Compile Remove="WaveWaveOutputsWaveFileWriterRT.cs" />
</ItemGroup>