.Csproj文件学习笔记.pdfVIP

.Csproj⽂件学习笔记

VisualStudio现在使⽤.csproj⽂件来管理项⽬。我们可以通过右键单击项⽬并选择Editproject-name.csproj来编辑.csproj设置，如下所

⽰。

上⾯项⽬的.csproj如下所⽰。

csproj⽂件包括与⽬标.NETFramework，项⽬⽂件夹，NuGet程序包引⽤等相关的设置。

.csproj是基于XML的格式。以下⽰例显⽰了使⽤.NETCore项⽬的根节点Microsoft.NET.Sdk。对于Web项⽬，使⽤

的SDK是Microsoft.NET.Sdk.Web。

ProjectSdk=Microsoft.NET.Sdk

...

/Project

我们可以⾃⼰直接编辑.csproj⽂件，并⼿动添加必要的项⽬。所需的确切代码取决于需要链接的⽂件类型以及所需的MSBuild操作类型。

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

ItemGroup

CompileInclude=..\OtherFolder\MySharedClass.csLink=MySharedClass.cs/

/ItemGroup

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

名。

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

ItemGroup

ContentInclude=..\Shared\SharedSettings.jsonLink=SharedSettings.jsonCopyToOutputDirectory=PreserveNewest/

/ItemGroup

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

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

PackageReferenceInclude=package-idVersion=PrivateAssets=IncludeAssets=ExcludeAssets=/

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

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

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

PrivateAssets属性指定PackageReference应使⽤属于指定包的哪些资产，但不应流到下⼀个项⽬。的Analyzers，Build和ContentFiles资

产都默认为私享此属性不存在。

多个⽬标框架

我们可以创建.NETCore应⽤程序并为其配置多个⽬标框架，以便它可以与所有已配置的⽬标框架⼀起运⾏。要定位多个框架，需要更

改TargetFramework为复数，TargetFrameworks并包含我们要定位的不同框架的别名，并⽤;分隔：

PropertyGroup

TargetFrameworksnetstandard2.0;net462/TargetFrameworks

/PropertyGroup

条件引⽤

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

例如，我们将以下⽅法添加到我们的库中，它将成功编译.NETStandard2.0⽬标，但.NET4.6.2⽬标将失败，因为它找不到.NET的定

义HttpUtility。

publicstringJavaScriptEncode(stringinput)

{

returnHttpUtility.JavaScriptStringEncode(input);

}

要解决此问题，我们需要添加对System.Web程序集的引⽤，但仅.NET4.6.2⽬标需要它。为此，我们只需.csproj使⽤以下语法在⽂件中添加

条件引⽤即可：

ItemGroupCondition=$(TargetFramework)==net462

ReferenceInclude=System.Web/

/ItemGroup

如果要有条件引⽤的NuGet程序包，则使⽤PackageReference