.NET Standard中配置TargetFrameworks输出多版本类库
在.NET Standard/.NET Core技术出现之前，编写一个类库项目（暂且称为基础通用类库PA）且需要支持不同 .NET Framework 版本，那么可行的办法就是创建多个不同版本的项目（暂且称为PB1、PB2、PB3 ... PBn）。PB1、PB2、PB3 ... PBn项目分别执行下面操作：【添加】--【现有项】--【添加为链接的方式】，将PA项目代码文件添加到各自项目中，如果代码不同，则需要使用#if #else #endif 等标签来判断 .NET Framework 版本。而在.NET Standard/.NET Core技术出现之后，可以通过配置SDK 样式项目中的目标框架来支持一套代码同时输出多版本类库。
下面以Visual Studio 2019 来演示整个操作过程。
1、新建一个 .NET Standard 类库。
2、填写项目名称
3、创建完成后，查看“解决方案资源管理器”，项目下面多了一个“依赖项”节点，子节点是SDK，孙子节点是 NETStandard.Library(2.0.3）。
项目组织方式与传统类库项目的组织方式不同
4、项目，右键【属性】-->【应用程序】--> “目标框架”默认是 .NET Standard 2.0。
也可以修改为其他版本
5、编译项目，查看bin --> debug。生成了 netstandard2.0目录
目录里面生成的DLL，这与传统.NET Framework 类型的类库项目生成结果相同。
6、项目，右键 --> “编辑项目文件”
可以看到当前类库默认为 netstandard2.0，而此时其xml标签为 TargetFramework。
如果要支持多版本，则需要做调整，将 TargetFramework 节点修改为 TargetFrameworks，再添加目标版本。
7、配置多目标框架
关于如何指定多目标框架，请参考博客《.NET Standard SDK 样式项目中的目标框架》
我做的BIMFACE二次开发的接口的目标是支持 .NET Framework4.0、.NET Framework4.5 以及 .NET Core3.1。所以配置了选下3个目标版本
<PropertyGroup>
<TargetFrameworks>net40;net45;netstandard2.0;</TargetFrameworks> <!--输出多版本类库-->
</PropertyGroup>
修改后并保存，Visual Studio 会弹出黄色背景的提示信息。
这里一定要点击【重新加载项目】按钮。重新加载后，依赖项中出现了如下图所示的3个项
展开每个项查看， 每个版本的程序集对应一个单独的依赖项节点。
8、项目，右键【属性】-->【应用程序】--> “目标框架”被禁用，因为单个项目支持多版本类库，无法一次呈现多个，这是正确的。
9、重新编译项目，查看bin --> debug，生成了3种不同版本的目标程序集。
通过上面的步骤我们已经实现了多版本输出，但是在实际的企业级业务系统开发时情况比较复杂，还需要解决以下几个问题：
1、条件编译
2、引用本地程序集
3、NuGet方式引用程序集
4、XML文档输出
5、编码与DEBUG 调试
6、自动生成内部版本号
7、文件复制
下面逐步讲解如何解决以上问题。
这是VS中默认的编译输出目录。
如果需要配置不同的类库输出到不同的位置，也可以自定义配置输出路径实现。
查看项目属性，【生成】-->“输出”-->“输出路径”中输入自定义目录或者点击【浏览】按钮选择一个目录。
填写后，保存项目。项目右键，【编辑项目文件】，csproj文件中自动增加了如下配置，其中 Condition 后面的表达式即是编译条件。OutputPath即是自定义输出目录。
<PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|net40|AnyCPU'">
<OutputPath>bin\Debug\</OutputPath>
</PropertyGroup>
按照以上方式再复制2份，分别配置 net45 与 netstandard2.0版。完整配置如下：
<!--条件编译-->
<PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|Release|net40|AnyCPU'">
<OutputPath>bin\Debug\</OutputPath><!--编译后的文件输出目录-->
</PropertyGroup>
<!--条件编译-->
<PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|Release|net45|AnyCPU'">
<OutputPath>bin\Debug\</OutputPath>
</PropertyGroup>
<!--条件编译-->
<PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|Release|netstandard2.0|AnyCPU'">
<OutputPath>bin\Debug\</OutputPath>
</PropertyGroup>
bin\Debug\ 是我自己定义的输出目录，大家可以根据实际需求填写其他目录。
$(Configuration) 的条件值有：Debug、Release。
$(TargetFramework)的条件为 <TargetFrameworks>节点中配置的值。
$(Platform) 的条件值有：
查看项目属性，【生成】-->“常规”-->“条件编译和符号”中输入自定义内容。选择 “定义DEGUG常数” 与 “定义TRACE常量”，保存项目。
查看csproj文件，在第一个目标版本对应的 <PropertyGroup> 配置节点下增加了
<DefineConstants>TRACE;DEBUG;NET_FULL;TEST;</DefineConstants>
为了做统一配置，将其提取出来
<PropertyGroup Condition=" '$(Configuration)' == 'Debug|Release' "> <!--统一定义的常量--> <DefineConstants>TRACE;DEBUG;RELEASE;NET_FULL;TEST;</DefineConstants> </PropertyGroup>
在下图中可以看出由于3个不同的输出类库中所引用的程序集是不同的，那么当编译时，一定是每个类库进行单独编译，这时就就需要通过某种方式告诉编译器当前编译的类库版本是什么，然后添加针对具体版本的第三方程序集引用。
.NET Standard 指定多个目标框架时，可有条件地为每个目标框架引用程序集。
以下库项目面向 .NET Standard (netstandard1.4) 和 .NET Framework（net40 和 net45）的 API。 将复数形式的 TargetFrameworks 元素与多个目标框架一起使用。 为两个 .NET Framework TFM 编译库时，Condition 属性包括特定于实现的包：
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFrameworks>netstandard2.0;net40;net45</TargetFrameworks>
</PropertyGroup>
<!-- 有条件地获取.NET Framework 4.0 目标的引用 -->
<ItemGroup Condition=" '$(TargetFramework)' == 'net40' ">
<Reference Include="System.Net" />
</ItemGroup>
<!-- 有条件地获取.NET Framework 4.5 目标引用 -->
<ItemGroup Condition=" '$(TargetFramework)' == 'net45' ">
<Reference Include="System.Net.Http" />
<Reference Include="System.Threading.Tasks" />
</ItemGroup>
</Project>
下面开始添加引用，点击项目子节点【依赖项】-->【添加程序集引用】
打开如下界面。默认加载的目标框架显示为 .NET Framework 4。
如何才能添加 net45 或者 netstandard2.1 的引用呢？正常来说应该在VS的“引用管理器”界面上提供目标框架的下拉选择框，可以自由切换选择不同的目标框架，但是到目前为止VS没有此功能，我的VS版本信息如下
希望微软在后续VS版本中能增加此功能。
回到csproj编辑界面，可以看到 TargetFrameworks 值第一个为 net40，估计与这个有关系。
通过取巧的方式调整 TargetFrameworks 里的版本先后顺序，保存后，重启VS（我的VS2019是这种情况，需要重启才生效。不知道其他小伙伴们的VS是不是保存后可以自动切换呢？）
再次添加程序集引用，此时加载了 .NET Framework 4.5
添加一个“System.Net.dll”引用来测试一下
添加后，如下图所示
.NET Framework 4.5 项目中多了“System.Net.dll”引用。但是 .NET Standard 2.0 前面显示黄色警告符合。展开所有依赖项，.NET Framework 4.0 与 .NET Framework 4.5 都已经正确引用。
.NET Standard 2.0 程序及引用有警告。这表示 netstandard2.0 并不知道 System.Net.dll 是什么。
查看.csproj文件
红色框内的配置，表示net40、.net45 和 netstand2.0 都需要“System.Net”引用（即统一配置），而实际只有 net40、.net45 才需要该引用，所以这里我们要使用 Condition 条件，修改如下：
这样只有 .net40 与 .net45 条件下才引用“System.Net.dll”。保存后，发现 netstand2.0 下面的警告标示消失了。
下面演示添加一个多版本都支持的第三方类库，NLog 日志组件，目前最新版本为4.7.5。通过 NuGet 方式添加引用
下图可以看出该组件同时支持 .NET4.0、.NET4.5 以及 .NET Standard 2.0
点击【安装】
点击【确定】，安装完成后，每一个类库均添加了引用
查看.csproj文件，添加了如下配置
注意这里是 PackageReference，而之前程序集的是 Reference，而且我们也会发现在VS解决方案管理器中并没有出现 packages.config 文件。默认在 sln 文件的同级也没有创建一个 packages 文件夹。
而是将dll下载到了C:\Users\当前登录用户\.nuget目录下，这与java的Maven管理方式类似。我的本地路径为：C:\Users\Savion\.nuget\packages
下面再添加一个 netstandard 专有的 nuget 引用 Microsoft.Extensions.DependencyInjection.dll
点击【安装】
点击【确定】
点击【我接受】。
添加完后解决方案中仅有 .NET Standard2.0 中增加了引用。.net40 与 .net45 中没有引用。
添加完后 csproj文件 会多出如下配置
NuGet 很智能，自动把 Condition 给加好了。
选择项目，点击 属性-->生成，勾选 “XML 文档文件”。默认生成的xml文件名称包含绝对路径，这个名称不是很友好，一般修改为程序集的名称即可
点击菜单栏上的【保存】按钮。查看.csproj文件新增了如下配置：
这表示 net40 会生成 xml 文件，将该配置信息复制两份，然后修改 Platform 以及输出路径为 net45 与 netstandard2.0。完整配置如下：
<!--条件编译-->
<PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|Release|net40|AnyCPU'">
<DocumentationFile>ZCN.NET.BIMFace.SDK.xml</DocumentationFile><!--xml文档，输出类库中方法与参数的注释等信息-->
<OutputPath>bin\Debug\</OutputPath><!--编译后的文件输出目录-->
</PropertyGroup>
<!--条件编译-->
<PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|Release|net45|AnyCPU'">
<DocumentationFile>ZCN.NET.BIMFace.SDK.xml</DocumentationFile>
<OutputPath>bin\Debug\</OutputPath>
</PropertyGroup>
<!--条件编译-->
<PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|Release|netstandard2.0|AnyCPU'">
<DocumentationFile>ZCN.NET.BIMFace.SDK.xml</DocumentationFile>
<OutputPath>bin\Debug\</OutputPath>
</PropertyGroup>
重新编译项目，查看输出目录里面的内容
其中ZCN.NET.BIMFace.SDK.xml 内容如下
.netstandard2.0 中多了一个 ZCN.NET.BIMFace.SDK.deps.josn 文件，里面包含了运行时环境以及依赖项等信息
/// <summary>
/// 判断字符串是否为null、空或者空白
/// </summary>
/// <param name="str">待判断的字符串</param>
/// <returns></returns>
public static bool IsNullOrWhiteSpace(this string str)
{
return string.IsNullOrEmpty(str.Trim());
}
在.NET4.0及以上框架下使用下面的方式实现
/// <summary>
/// 判断字符串是否为null、空或者空白
/// </summary>
/// <param name="str">待判断的字符串</param>
/// <returns></returns>
public static bool IsNullOrWhiteSpace(this string str)
{
return string.IsNullOrWhiteSpace(str);
}
2种框架下实现的逻辑方式不同，为了只编写一套代码(该情况为一个方法)，此时就需要使用预处理指令编写条件指令。
在库或应用中，使用预处理器指令编写条件代码，针对每个目标框架进行编译。关于预处理指令请参考《C# 预处理器指令》
使用预处理指令编写条件代码的实现方式如下：
/// <summary>
/// 判断字符串是否为null、空或者空白
/// </summary>
/// <param name="str">待判断的字符串</param>
/// <returns></returns>
public static bool IsNullOrWhiteSpace(this string str)
{
#if NET35
return string.IsNullOrEmpty(str.Trim());
#else
return string.IsNullOrWhiteSpace(str);
#endif
}
上面的实现方式是在一个方法内进行条件区分，下面介绍在同一个类中（方法之外），使用条件区分不同逻辑的实现方式
#if NET35 || NET40 || NET45
/// <summary>
/// 对URL字符串进行编码
/// <para>注意：.NET Core 转义后字母为大写</para>
/// </summary>
/// <param name="url">有效的url字符串</param>
/// <param name="encoding">编码，默认为 UTF8</param>
/// <returns></returns>
public static string UrlEncode(this string url, Encoding encoding = null)
{
encoding = encoding ?? Encoding.UTF8;
return System.Web.HttpUtility.UrlEncode(url, encoding);
}
#else
/// <summary>
/// 对URL字符串进行编码
/// <para>注意：.NET Core 转义后字母为大写</para>
/// </summary>
/// <param name="url">有效的url字符串</param>
/// <returns></returns>
public static string UrlEncode(this string url)
{
return WebUtility.UrlEncode(url);//转义后字母为大写
}
#endif
上面两段代码中的预处理符号 NET35、NET40、NET45 是.NET目标框架中预定义的预处理符号。
使用 SDK 样式项目时，生成系统可识别预处理器符号，这些符号表示支持的目标框架版本表中所示的目标框架。 使用表示 .NET Standard、.NET Core 或 .NET 5 TFM 的符号时，请用下划线替换点和连字符，并将小写字母更改为大写字母（例如，netstandard1.4 的符号为 NETSTANDARD1_4）。
.NET 目标框架的预处理器符号的完整列表如下：
除此之外，开发者可以通过配置自定义常量的方式达到与.NET目标框架中预定义的预处理符号相同的功能。
<PropertyGroup Condition=" '$(Configuration)' == 'Release' "> <DefineConstants>TRACE;RELEASE</DefineConstants> <!--统一定义的常量--> </PropertyGroup>
上述代码片段通过 <DefineConstants> 节点 定义了2个常量（多个常量之间使用分号分隔）TRACE 与 RELEASE。
在编写C#代码时能够自动智能感知到自定义的常量
上面是定义的统一的全局变量，也可以在每个条件编译分组中自定义常量
<!--条件编译--> <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|net40|AnyCPU'"> <DocumentationFile>ZCN.NET.BIMFace.SDK.xml</DocumentationFile><!--xml文档，输出类库中方法与参数的注释等信息--> <OutputPath>bin\Debug\</OutputPath><!--编译后的文件输出目录--> <DefineConstants>NET_FULL</DefineConstants><!--独立定义的常量--> </PropertyGroup>
PropertyGroup，是包含一组用户定义的 Property 元素。 MSBuild 项目中使用的每个 Property 元素必须是 PropertyGroup 元素的子元素。其包含如下的子元素
更加完整详细的信息请参考微软官方文档《PropertyGroup 元素 (MSBuild)》
技巧：高版本的 Visual Studio 足够智能，能针对不同的API及时给出提示，指出API适用于哪种版本的.NET。比如下图中使用的 fileStream.WriteAsync()方法是异步方法，只在.NET4.5及.NET Standard2.0中受支持，在.NET4.0中没有异步方法，只有对应的 fileStream.Write()同步方法。
将代码修改为如下格式即可实现多版本
所以在编写代码时，建议在项目文件.csproj文件中做如下配置：
<PropertyGroup> <TargetFrameworks>netstandard2.0;net45;net40</TargetFrameworks> </PropertyGroup>也就是将 netstandard2.0 放置在第一个位置，因为在VS中编写代码时当前编辑器环境是针对放置在第一个位置的.NET版本。
- 以前的写法是在/Properties/AssemblyInfo.cs里通过
[assembly: AssemblyVersion("2.3.*")]这样的形式生成，但是现在默认关闭这个功能了，如果我们直接指定<AssemblyVersion>9.8.*</AssemblyVersion>会警告错误，加上<Deterministic>False</Deterministic>即可 -
为什么默认关闭？请了解下Roslyn中的确定性构建
-
其它生成方式、汇编内部版本号后面两位的生成规则，请看使用Visual Studio时是否可以自动增加文件构建版本、Visual Studio 2017中的自动版本控制（.NET Core）、如何有一个自动递增版本号（Visual Studio）
-
msbuildtasks也了解一下，如果要兼容以前的内部版本号生成规则，可自己动手
NuGet包相关
- 静态文件如何指定复制行为等，或许会发现安装NuGet之后希望能编辑的文件仅仅只是一个链接而已，如何让它包含在项目里面呢，请参考微软官方文档 NuGet ContentFiles揭秘，带回解决方案级包的讨论
- PackageReference 方式作为包管理格式，安装时不支持执行install.ps1等powershell相关脚本，init.ps1在解决方案第一次安装时可用。vs2017中，已不支持此功能，NuGet 3 - 什么和为什么-Powershell安装和卸载脚本
- 关于nuget包安装的相关行为估计都可以通过msbuild属性或者任务来搞定，这一切都是可以通过命令行来执行的，方便跨平台使用吧
- msbuildtasks也了解一下，可以代替ps1脚本完成想做的事
成在管理，败在经验；嬴在选择，输在不学！ 贵在坚持！
个人作品
BIMFace.SDK.NET
开源地址：https://gitee.com/NAlps/BIMFace.SDK
系列博客：https://www.cnblogs.com/SavionZhang/p/11424431.html
系列视频：https://www.cnblogs.com/SavionZhang/p/14258393.html
技术栈
1、AI、DeepSeek、MiniMax、通义千问
2、Visual Studio、.NET Core/.NET、MVC、Web API、RESTful API、gRPC、SignalR、Java、Python
3、jQuery、Vue.js、Bootstrap、ElementUI
4、数据库：分库分表、读写分离、SQLServer、MySQL、PostgreSQL、Redis、MongoDB、ElasticSearch、达梦DM、GaussDB、OpenGauss
5、架构：DDD、ABP、SpringBoot、jFinal
6、环境：跨平台、Windows、Linux
7、移动App：Android、IOS、HarmonyOS、微信小程序、钉钉、uni-app、MAUI
8、分布式、高并发、云原生、微服务、Docker、CI/CD、DevOps、K8S；Dapr、RabbitMQ、Kafka、RPC、Elasticsearch
欢迎关注作者头条号 张传宁IT讲堂，获取更多IT文章、视频等优质内容。
出处：www.cnblogs.com/SavionZhang
作者：张传宁 技术顾问、培训讲师、微软MCP、系统架构设计师、系统集成项目管理工程师、科技部创新工程师。
专注于企业级通用开发平台、工作流引擎、自动化项目(代码)生成器、SOA 、DDD、 云原生(Docker、微服务、DevOps、CI/CD）；PDF、CAD、BIM 审图等研究与应用。
多次参与电子政务、图书教育、生产制造等企业级大型项目研发与管理工作。
熟悉中小企业软件开发过程：可行调研、需求分析、架构设计、编码测试、实施部署、项目管理。通过技术与管理帮助中小企业实现互联网转型升级全流程解决方案。
本文版权归作者和博客园共有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。
如有问题，可以通过邮件905442693@qq.com联系。共同交流、互相学习。
如果您觉得文章对您有帮助，请点击文章右下角【推荐】。您的鼓励是作者持续创作的最大动力！
【推荐】国内首个AI IDE，深度理解中文开发场景，立即下载体验Trae
【推荐】编程新体验，更懂你的AI，立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包，你的智能百科全书，全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell：AI 加持，快人一步
· Linux系列：如何用 C#调用 C方法造成内存泄露
· AI与.NET技术实操系列（二）：开始使用ML.NET
· 记一次.NET内存居高不下排查解决与启示
· 探究高空视频全景AR技术的实现原理
· 理解Rust引用及其生命周期标识（上）
· DeepSeek 开源周回顾「GitHub 热点速览」
· 物流快递公司核心技术能力-地址解析分单基础技术分享
· .NET 10首个预览版发布：重大改进与新特性概览！
· AI与.NET技术实操系列（二）：开始使用ML.NET
· 单线程的Redis速度为什么快？
2014-10-10 SQLServer中的CTE通用表表达式
2014-10-10 SQL反模式学习笔记4 建立主键规范【需要ID】