.net 6.0新特性 隐式using指令

前言

在使用《最小Web API》时,我们发现,相比以前的代码,大量的using指令消失了:

.net 6.0新特性 隐式using指令

using指令的主要作用是允许使用在命名空间中定义的类型,而无需指定该类型的完全限定命名空间。

那么,在.NET 6下为什么不需要了呢?

ImplicitUsings属性

遍历项目下的所有文件,最后在csproj中找到这样一个属性,应该和using指令相关:

.net 6.0新特性 隐式using指令

将属性值改成disable,则编译失败:

.net 6.0新特性 隐式using指令

需要在文件顶部加上using指令:

.net 6.0新特性 隐式using指令

也就是说,编译时其实还是需要using指令的。

那它们写在哪了?

global using指令

打开obj目录(用于存放编译过程中生成的中间临时文件),在cs文件的对应目录发现了WebApplication1.GlobalUsings.g.cs文件:

.net 6.0新特性 隐式using指令

原来using都写在这里了:

// <auto-generated/>
global using global::Microsoft.AspNetCore.Builder;
global using global::Microsoft.AspNetCore.Hosting;
global using global::Microsoft.AspNetCore.Http;
global using global::Microsoft.AspNetCore.Routing;
global using global::Microsoft.Extensions.Configuration;
global using global::Microsoft.Extensions.DependencyInjection;
global using global::Microsoft.Extensions.Hosting;
global using global::Microsoft.Extensions.Logging;
global using global::System;
global using global::System.Collections.Generic;
global using global::System.IO;
global using global::System.Linq;
global using global::System.Net.Http;
global using global::System.Net.Http.Json;
global using global::System.Threading;
global using global::System.Threading.Tasks;

global using的官方文档说明如下:

向 using 指令添加 global 修饰符意味着 using 将应用于编译中的所有文件(通常是一个项目)

也就是说,对于任何命名空间,无需再在每个文件上写using指令,只需在一个文件中写global using指令即可。

而WebApplication1.GlobalUsings.g.cs文件是基于ImplicitUsings属性设置自动生成的。

那么,为啥会自动包含这些命名空间呢?

GenerateGlobalUsings任务

使用MSBuild Structured Log Viewer(使用方法请参看《天呐!你知道MSBuild都干了些什么》)查看MSBuild的输出日志,可以看到WebApplication1.GlobalUsings.g.cs文件是由GenerateGlobalUsings任务生成的:

.net 6.0新特性 隐式using指令

而任务参数数据来源于Using参数:

<GenerateGlobalUsings Usings="@(Using)">
    <Output TaskParameter="Lines" ItemName="_GlobalUsingLines" />
</GenerateGlobalUsings>

而具体值来源于项目引用的SDK:

.net 6.0新特性 隐式using指令

结论

了解原理后,我们可以使用项目文件,即可增加我们的自定义global using:

<ItemGroup>
    <Using Include="GlobalUsingDemo" />
</ItemGroup>

.net 6.0新特性 隐式using指令

利用隐式using指令,再也不用在cs文件中写using指令了!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 xxx@163.com 举报,一经查实,本站将立刻删除。

发表评论

登录后才能评论