.NET 6 Preview 5 中的 ASP.NET Core 更新
.NET 6 Preview 5 现已推出,其中包括对 ASP.NET Core 的许多重大改进。
以下是此预览版中的新功能:
.NET 热重载更新
dotnet watch
ASP.NET Core SPA 模板更新到 Angular 11 和 React 17
在 SVG
foreignObject
元素中使用 Razor 语法为
Action
和RenderFragment
组件参数指定 null通过运行时重链接减少 Blazor WebAssembly 下载大小
在 Json.NET 输出格式化程序中写入磁盘之前可配置的缓冲区阈值
用于更好地过滤 Kestrel 日志的子类别
更快地获取和设置 HTTP 标头
IIS 的可配置未消费的传入缓冲区大小
开始
要在 .NET 6 Preview 5 中开始使用 ASP.NET Core,请安装 .NET 6 SDK。
如果你在 Windows 上使用 Visual Studio,我们建议安装 Visual Studio 2019 16.11 的最新预览版。Visual Studio 2022 Preview 1也在今天发布,.NET 6 Preview 5 包含在该版本中。如果您使用的是 macOS,我们建议您安装 Visual Studio 2019 for Mac 8.10 的最新预览版。
要使用 .NET MAUI 和 Blazor 设置跨平台原生应用程序,请参阅.NET MAUI 入门指南 中的最新说明。请务必查看宣布 .NET MAUI 预览 5 的博客文章,了解有关此版本中 .NET MAUI 新增功能的所有详细信息。
注意:Visual Studio 2022 预览版 1 尚不支持 .NET MAUI。对于 .NET MAUI 开发,请改用 Visual Studio 2019 16.11 的最新预览版。
要安装用于提前 (AOT) 编译和运行时重新链接的最新 .NET WebAssembly 工具,请从提升的命令提示符运行以下命令:
dotnet workload install microsoft-net-sdk-blazorwebassembly-aot
如果您之前安装了 .NET WebAssembly 工作负载,您可以通过从提升的命令提示符运行以下命令将其更新到 .NET 6 Preview 5:
dotnet workload update
注意:使用 Visual Studio 2022 Preview 1 附带的 .NET 6 Preview 5 SDK 安装可选 SDK 工作负载存在一个已知问题。要解决此问题,请从 https://dot.net/ 安装 .NET 6 Preview 5 SDK安装 Visual Studio 2022 预览版 1 后的 get-dotnet6。
升级现有项目
要将现有的 ASP.NET Core 应用程序从 .NET 6 Preview 4 升级到 .NET 6 Preview 5:
将所有 Microsoft.AspNetCore.* 包引用更新为.
6.0.0-preview.5.*
将所有 Microsoft.Extensions.* 包引用更新为.
6.0.0-preview.5.*
要将 .NET MAUI Blazor 应用从 .NET 6 Preview 4 升级到 .NET 6 Preview 5,我们建议从使用 .NET 6 Preview 5 SDK 创建的新 .NET MAUI Blazor 项目开始,然后从原始项目复制代码。
查看 .NET 6 的 ASP.NET Core 重大变更的完整列表。
.NET 热重载更新 dotnet watch
我们一直致力于对 .NET 6 的 .NET Hot Reload 进行各种改进。其中一些改进在 .NET 6 Preview 5 中可用,而其他改进仍在进行中,将在未来的预览更新中完善。
您不再需要在 launchSettings.json 中指定hotReloadProfile
以使用dotnet watch
来启用 .NET Hot Reload . 能够支持热重载的项目现在会默认启用 .NET 热重载。
当进行了无法热重载的代码编辑(“粗鲁”编辑)时,dotnet watch
现在将询问您是否要重新启动应用程序以应用更改:
watch : Unable to apply hot reload because of a rude edit. Rebuilding the app...
watch : Unable to handle changes to C:\Users\daroth\Desktop\BlazorApp\Pages\Index.razor.
watch : Do you want to restart your app - Yes (y) / No (n) / Always (a) / Never (v)?
这些选项具有以下行为:
选择 是 将重新启动应用程序。
选择 否 不会重新启动应用程序,并且会保持应用程序运行而不应用更改。
当无法热重新加载更改时,选择“*始终”*将根据需要重新启动应用程序。
选择 从不 不会重新启动应用程序并避免将来出现提示。
您始终可以使用 Ctrl+R 手动重新启动应用程序。
注意:此版本中存在一个已知问题,即选择“*始终”*仍会继续提示将来进行粗鲁编辑。这将在未来的预览版本中得到解决。
要在使用时禁用对 .NET Hot Reload 的支持dotnet watch
,请使用命令行选项。--no-hot-reload
使用 dotnet watch
进行 .NET Hot Reload 现在也将正确检测 Blazor WebAssembly 应用程序中的“粗鲁”编辑。当刷新浏览器或在单独的浏览器 Tab 或浏览器实例中加载应用程序时,应用于 Blazor WebAssembly 应用程序的更改将重新应用于应用程序。
ASP.NET Core SPA 模板更新到 Angular 11 和 React 17
用于 Angular 和 React 的 ASP.NET Core 单页应用 (SPA) 模板已更新为 Angular 11 和 React 17。我们还希望在未来的 .NET 6 预览版中将 Angular 模板进一步更新为 Angular 12,因为 Angular 12 已经正式发布了。
在 SVG foreignObject
元素中支持 Razor 语法
您现在可以在 SVGforeignObject
元素中使用 Razor 语法,包括使用 Blazor 组件:
<svg width="200" height="200" xmlns="http://www.w3.org/2000/svg">
<rect x="0" y="0" rx="10" ry="10" width="200" height="200" stroke="black" fill="none" />
<foreignObject x="20" y="20" width="160" height="160">
<p>@message</p>
</foreignObject>
</svg>
@code {
string message = "Wow, it's so nice that this text wraps like it's HTML...because that's what it is!";
}
我们还进行了大量验证和测试,以确保 Blazor 对 SVG 场景有良好的支持。我们认为 Blazor 的 SVG 支持现在处于良好状态。如果您在此版本的 Blazor 中使用 SVG 遇到任何问题,请通过在GitHub 上创建 Issue 告诉我们。
为Action
和RenderFragment
组件参数指定 null
现在,您可以指定Blazor组件参数值Action
和RenderFragment
为 null,从而简化采取可选的回调参数或模板参数的新组件。
通过运行时重链接减少 Blazor WebAssembly 下载大小
默认 Blazor WebAssembly 应用程序的最大部分之一是该应用程序依赖的基于 WebAssembly 的 .NET 运行时 ( dotnet.wasm )。Blazor WebAssembly 已经支持从 .NET 核心框架库中修剪未使用的代码。但是运行时的下载大小一直是固定的。
并非每个应用程序都需要所有运行时逻辑。例如,很大一部分运行时逻辑和相关数据文件是针对全球化场景的。这种全球化支持使 Blazor WebAssembly 应用程序能够根据当前文化处理字符串、数字、日期等。但是对于不需要此功能的应用程序,这些数据和逻辑都只是多余的。
不需要全球化功能的 .NET 应用程序可以选择不要它,通过在其项目文件中设置InvariantGlobalization
属性为true
来使用不变的全球化。在 .NET 5 中,这将允许 Blazor WebAssembly 应用程序避免下载全球化数据,但仍会包含 .NET 运行时中的相关逻辑。
在 .NET 6 Preview 5 中,您现在可以使用 .NET WebAssembly 工具(与用于 .NET WebAssembly AOT 编译的工具相同)重新链接运行时以删除不需要的逻辑并显着减小运行时的大小。如果您安装了 .NET WebAssembly 工作负载,则在您发布应用程序时会自动完成运行时重新链接。使用不变全球化模式时,大小减少尤其显着。
如果您还没有安装 .NET WebAssembly 工具,可以通过从管理员模式的命令提示符运行以下命令来安装:
dotnet workload install microsoft-net-sdk-blazorwebassembly-aot
下表显示了使用 .NET 5 和 .NET 6 的默认 Blazor WebAssembly 项目的dotnet.wasm传输大小:
dotnet.wasm | 传输大小 (kB) |
---|---|
.NET 5 默认 | 884 |
.NET 6 默认 | 780 |
.NET 6 重新链接 | 756 |
.NET 6 不变模式 | 393 |
在 Json.NET 输出格式化程序中写入磁盘之前可配置的缓冲区阈值
默认情况下,Newtonsoft.Json
输出格式化程序(output formatter)在缓冲到磁盘之前在内存中缓冲高达 32 KiB 的响应。这是为了避免执行同步 IO,但是这会导致其他副作用,例如线程饥饿和应用程序死锁。但是,如果您的响应大于 32 KiB,则会导致大量可避免的磁盘 I/O。您现在可以在缓冲到磁盘之前配置内存阈值。
public void ConfigureServices(IServiceCollection services)
{
services.AddRazorPages()
.AddNewtonsoftJson(options =>
{
options.OutputFormatterMemoryBufferThreshold = 48 * 1024;
});
}
注意:我们仍然建议使用
System.Text.Json
output formatter,除非出于兼容性原因需要Newtonsoft.Json
序列化程序。System.Text.Json
序列化程序是完全异步的,将有效地适用于任何大小的有效载荷。
用于更好地过滤 Kestrel 日志的子类别
在此更改之前,为 Kestrel 启用详细日志记录非常昂贵,因为所有 Kestrel 共享相同的日志记录类别名称 (Microsoft.AspNetCore.Server.Kestrel )。我们现在将该类别拆分为多个新的子类别:
Microsoft.AspNetCore.Server.Kestrel
(当前类别):ApplicationError、ConnectionHeadResponseBodyWrite、ApplicationNeverCompleted、RequestBodyStart、RequestBodyDone、RequestBodyNotEntirelyRead、RequestBodyDrainTimedOut、ResponseMinimumDataRateNotSatisfied、InvalidResponseHeaderRemoved、HeartbeatSlow。Microsoft.AspNetCore.Server.Kestrel.BadRequests
:ConnectionBadRequest、RequestProcessingError、RequestBodyMinimumDataRateNotSatisfied。Microsoft.AspNetCore.Server.Kestrel.Connections
:ConnectionAccepted、ConnectionStart、ConnectionStop、ConnectionPause、ConnectionResume、ConnectionKeepAlive、ConnectionRejected、ConnectionDisconnect、NotAllConnectionsClosedGracefully、NotAllConnectionsAborted、ApplicationAbortedConnection。Microsoft.AspNetCore.Server.Kestrel.Http2
: Http2ConnectionError, Http2ConnectionClosing, Http2ConnectionClosed, Http2StreamError, Http2StreamResetAbort, HPackDecodingError, HPackEncodingError, Http2FrameReceived, Http2FrameSending, Http2MaxConcurrentStreamsReached。Microsoft.AspNetCore.Server.Kestrel.Http3
: Http3ConnectionError, Http3ConnectionClosing, Http3ConnectionClosed, Http3StreamAbort, Http3FrameReceived, Http3FrameSending。
虽然您现有的规则将继续有效(日志过滤应用具有最长匹配类别前缀的规则),但您现在可以更有选择性地选择启用哪些规则。例如,使用 Debug
为 bad requests 启用日志记录的可观察性开销大大降低,可以通过以下配置实现:
{
"Logging": {
"LogLevel": {
"Microsoft.AspNetCore.Kestrel.BadRequests": "Debug"
}
}
}
更快地获取和设置 HTTP 头
我们添加了新的 API 以将 System.Net.Http.HeaderNames
所有可用的通用标头公开为属性,从而使 Microsoft.AspNetCore.Http.IHeaderDictionary
API 更易于使用。例如,下面的内联中间件使用新 API 获取/设置请求和响应标头:
app.Use(async (context, next) =>
{
var hostHeader = context.Request.Headers.Host;
app.Logger.LogInformation("Host header: {host}", hostHeader);
context.Response.Headers.XPoweredBy = "ASP.NET Core 6.0-preview5";
await next.Invoke(context);
var dateHeader = context.Response.Headers.Date;
app.Logger.LogInformation("Response date: {date}", dateHeader);
});
对于已实现的标头,get
/set
访问器是通过直接转到字段并绕过查找来实现的。对于未实现的标头,访问者可以绕过针对已实现标头的初始查找并直接执行查找 Dictionary<string, StringValues>。这导致两种情况下的访问速度更快。
方法 | 分支 | 类型 | 平均 | 操作/秒 | Delta |
---|---|---|---|---|---|
GetHeaders | 预览4 | 纯文本 | 25.793 纳秒 | 38,770,569.6 | —— |
GetHeaders | 预览5 | 纯文本 | 12.775 纳秒 | 78,279,480.0 | +101.9% |
GetHeaders | 预览4 | 常见的 | 121.355 纳秒 | 8,240,299.3 | —— |
GetHeaders | 预览5 | 常见的 | 37.598 纳秒 | 26,597,474.6 | +222.8% |
GetHeaders | 预览4 | 未知 | 366.456 纳秒 | 2,728,840.7 | —— |
GetHeaders | 预览5 | 未知 | 223.472 纳秒 | 4,474,824.0 | +64.0% |
SetHeaders | 预览4 | 纯文本 | 49.324 纳秒 | 20,273,931.8 | —— |
SetHeaders | 预览5 | 纯文本 | 34.996 纳秒 | 28,574,778.8 | +40.9% |
SetHeaders | 预览4 | 常见的 | 635.060 纳秒 | 1,574,654.3 | —— |
SetHeaders | 预览5 | 常见的 | 108.041 纳秒 | 9,255,723.7 | +487.7% |
SetHeaders | 预览4 | 未知 | 1,439.945 纳秒 | 694,470.8 | —— |
SetHeaders | 预览5 | 未知 | 517.067 纳秒 | 1,933,985.7 | +178.4% |
IIS 的可配置未消耗传入缓冲区大小
在此更改之前,IIS 服务器仅缓冲 64 KiB 的未使用请求正文。这导致读取被限制在最大大小,这会影响大型请求正文(例如大文件上传)时的性能。在 .NET 6 Preview 5 中,我们将默认缓冲区大小从 64 KiB 更改为 1 MiB,这应该会提高大型上传的吞吐量。在我们的测试中,过去需要 9 秒的 700 MiB 上传现在只需 2.5 秒。
较大缓冲区大小的缺点是,当应用程序不能快速读取请求正文时,每个请求的内存消耗会增加。因此,除了更改默认缓冲区大小外,我们还使缓冲区大小可配置,允许您根据工作负载进行调整。
public void ConfigureServices(IServiceCollection services)
{
services.Configure<IISServerOptions>(
options =>
{
options.MaxRequestBodySize = 64 * 1024;
}
);
}
给予反馈
我们希望您喜欢 .NET 6 中 ASP.NET Core 的这个预览版本。我们很想知道您对这个版本的体验。通过在GitHub 上提交问题让我们知道您的想法。
感谢您试用 ASP.NET Core!