【译】.NET 7 预览版 1 中的 ASP.NET Core 更新

V2AS问路

【译】.NET 7 预览版 1 中的 ASP.NET Core 更新

阅读原文时间：2022年03月09日阅读：1

原文 | Daniel Roth

翻译 | 郑子铭

.NET 7 预览版 1 现已推出！这是 .NET 下一个主要版本的第一个预览版，其中将包括使用 ASP.NET Core 进行 Web 开发的下一波创新。

在 .NET 7 中，我们计划对 ASP.NET Core 进行广泛投资。以下是我们计划重点关注的一些领域：

性能：.NET 6 包含对 ASP.NET Core 的许多性能改进，我们将努力使 ASP.NET Core 在 .NET 7 中更快、更高效。
HTTP/3：HTTP/3 支持作为 .NET 6 中的预览功能提供。对于 .NET 7，我们希望完成它并使其成为默认启用的受支持功能。在未来的预览版中，您可以期待在我们的 HTTP/3 支持中看到高级 TLS 功能和更多性能改进。
最小 API：添加对端点过滤器和路由分组的支持，作为最小 API 的核心原语。通常还简化 API 的身份验证和授权配置。
gRPC：我们正在投资 gRPC JSON 转码。此功能允许 gRPC 服务像带有 JSON 请求和响应的 RESTful HTTP API 一样被调用。
SignalR：添加对强类型客户端的支持并从客户端调用返回结果。
Razor：我们将对 Razor 编译器进行各种改进，以提高性能、弹性并促进改进的工具。
Blazor：在完成对 .NET MAUI、WPF 和 Windows 窗体的 Blazor Hybrid 支持后，我们将对 Blazor 进行广泛的改进，包括：
- 新的 .NET WebAssembly 功能：混合模式 AOT、多线程、Web 加密。
- 增强的热重载支持。
- 数据绑定改进。
- 更灵活的预渲染。
- 更好地控制 Blazor 服务器电路的生命周期。
- 改进了对微前端的支持。
MVC：对端点路由、链接生成和参数绑定的改进。
Orleans：ASP.NET Core 和 Orleans 团队正在研究进一步调整和集成 Orleans 分布式编程模型与 ASP.NET Core 的方法。 Orleans 4 将与 .NET 7 一起发布，并专注于简单性、可维护性和性能，包括人类可读的流标识和新的优化、版本容忍的序列化程序。

有关为 .NET 7 计划的特定 ASP.NET Core 工作的更多详细信息，请参阅 GitHub 上针对 .NET 7 的完整 ASP.NET Core 路线图。

.NET 7 Preview 1 是众多 .NET 7 预览版中的第一个，为 2022 年 11 月的 .NET 7 版本做准备。

我在最近一集 On .NET 中加入了 James Montemagno，以分解 .NET 7 和 .NET 7 中的 ASP.NET Core 中的所有内容：

以下是此预览版中新增内容的摘要：

最小的 API 改进：
- IFormFile 和 IFormFileCollection 支持
- 将请求正文绑定为 Stream 或 PipeReader
- JSON 选项配置
SignalR 客户端源生成器
支持 MVC 视图和 Razor 页面中的可为空模型
在验证错误中使用 JSON 属性名称
改进了 dotnet watch 的控制台输出
将 dotnet watch 配置为始终重新启动以进行粗鲁的编辑
在 ValidationAttribute 中使用依赖注入
更快的标头解析和写入
gRPC JSON 转码

开始使用

要开始使用 .NET 7 Preview 1 中的 ASP.NET Core，请安装 .NET 7 SDK。

如果您在 Windows 上使用 Visual Studio，我们建议安装最新的 Visual Studio 2022 预览版。 Visual Studio for Mac 对 .NET 7 预览的支持尚不可用，但即将推出。

要安装最新的 .NET WebAssembly 构建工具，请从提升的命令提示符处运行以下命令：

dotnet workload install wasm-tools

升级现有项目

要将现有的 ASP.NET Core 应用从 .NET 6 升级到 .NET 7 Preview 1：

将您的应用程序的目标框架更新为 net7.0。
将所有 Microsoft.AspNetCore.* 包引用更新到 7.0.0-preview.1.*。
将所有 Microsoft.Extensions.* 包引用更新到 7.0.0-preview.1.*。

另请参阅 .NET 7 的 ASP.NET Core 中的重大更改的完整列表。

IFormFile 和 IFormFileCollection 支持

您现在可以使用 IFormFile 和 IFormFileCollection 在最少的 API 中处理文件上传：

app.MapPost("/upload", async(IFormFile file) =>
{
    using var stream = System.IO.File.OpenWrite("upload.txt");
    await file.CopyToAsync(stream);
});


app.MapPost("/upload", async (IFormFileCollection myFiles) => { ... });

将此功能与身份验证一起使用需要防伪支持，但尚未实现。我们的 .NET 7 路线图包含对最小 API 的防伪支持。当请求包含 Authorization 标头、客户端证书或 cookie 标头时，绑定到 IFormFile 或 IFormFileCollection 当前被禁用。我们将在完成防伪支持工作后立即解决此限制。

感谢 @martincostello 贡献此功能。

将请求正文绑定为 Stream 或 PipeReader

您现在可以将请求正文绑定为 Stream 或 PipeReader，以有效地支持用户必须摄取数据并将其存储到 blob 存储或将数据排队到队列提供程序（Azure 队列等）以供以后处理的场景工作者或云功能。以下示例显示了如何使用新绑定：

app.MapPost("v1/feeds", async (QueueClient queueClient, Stream body, CancellationToken cancellationToken) =>
{
    await queueClient.CreateIfNotExistsAsync(cancellationToken: cancellationToken);
    await queueClient.SendMessageAsync(await BinaryData.FromStreamAsync(body), cancellationToken: cancellationToken);
});

使用 Stream 或 PipeReader 时，需要考虑以下几点：

摄取数据时，Stream 将是与 HttpRequest.Body 相同的对象。
默认情况下不缓冲请求正文。读取正文后，它不可回退（您不能多次读取流）。
Stream/PipeReader 在最小操作处理程序之外不可用，因为底层缓冲区将被释放和/或重用。

JSON 选项配置

我们正在引入一个新的更简洁的 API，ConfigureRouteHandlerJsonOptions，为最小的 API 端点配置 JSON 选项。这个新的 API 避免了与 Microsoft.AspNetCore.Mvc.JsonOptions 的混淆。

var builder = WebApplication.CreateBuilder(args);
builder.Services.ConfigureRouteHandlerJsonOptions(options =>
{
    //Ignore Cycles
    options.SerializerOptions.ReferenceHandler = ReferenceHandler.IgnoreCycles;
});

感谢@mehmetakbulut 的贡献，我们为 SignalR 添加了一个新的客户端源生成器。

SignalR 客户端源生成器根据您定义的接口生成强类型的发送和接收代码。您可以在客户端上重用来自强类型 SignalR 集线器的相同接口来代替松散类型的 .On("methodName", …) 方法。同样，您的集线器可以为其方法实现一个接口，并且客户端可以使用该相同接口来调用集线器方法。

要使用 SignalR 客户端源生成器：

添加对 Microsoft.AspNetCore.SignalR.Client.SourceGenerator 包的引用。
将 HubServerProxyAttribute 和 HubClientProxyAttribute 类添加到您的项目中（这部分设计可能会在未来的预览版中更改）：

[AttributeUsage(AttributeTargets.Method)]
internal class HubServerProxyAttribute : Attribute
{
}

[AttributeUsage(AttributeTargets.Method)]
internal class HubClientProxyAttribute : Attribute
{
}
为您的项目添加一个静态分部类，并使用 [HubClientProxy] 和 [HubServerProxy] 属性编写静态分部方法

internal static partial class MyCustomExtensions
{
[HubClientProxy]
public static partial IDisposable ClientRegistration(this HubConnection connection, T provider);
```
[HubServerProxy]
public static partial T ServerProxy<T>(this HubConnection connection);
```
}
使用代码中的部分方法！

public interface IServerHub
{
Task SendMessage(string message);
Task Echo(int i);
}

public interface IClient
{
Task ReceiveMessage(string message);
}

public class Client : IClient
{
// Equivalent to HubConnection.On("ReceiveMessage", (message) => {});
Task ReceiveMessage(string message)
{
return Task.CompletedTask;
}
}

HubConnection connection = new HubConnectionBuilder().WithUrl("…").Build();
var stronglyTypedConnection = connection.ServerProxy();
var registrations = connection.ClientRegistration(new Client());

await stronglyTypedConnection.SendMessage("Hello world");
var echo = await stronglyTypedConnection.Echo(10);

我们启用了定义一个可为空的页面或视图模型来改进在 ASP.NET Core 应用中使用空状态检查时的体验：

@model Product?

当模型验证生成 ModelErrorDictionary 时，默认情况下它将使用属性名称作为错误键（“MyClass.PropertyName”）。模型属性名称通常是一个实现细节，这会使它们难以从单页应用程序中处理。您现在可以将验证配置为使用相应的 JSON 属性名称，而不是使用新的 SystemTextJsonValidationMetadataProvider（或使用 Json.NET 时的 NewtonsoftJsonValidationMetadataProvider）。

services.AddControllers(options =>
{
    options.ModelMetadataDetailsProviders.Add(new SystemTextJsonValidationMetadataProvider())
});

我们清理了 dotnet watch 的控制台输出，以更好地与 ASP.NET Core 的注销保持一致，并在表情符号.中脱颖而出。

以下是新输出的示例：

C:BlazorApp> dotnet watch
dotnet watch  Hot reload enabled. For a list of supported edits, see https://aka.ms/dotnet/hot-reload.
   Press "Ctrl + R" to restart.
dotnet watch  Building...
  Determining projects to restore...
  All projects are up-to-date for restore.
  You are using a preview version of .NET. See: https://aka.ms/dotnet-support-policy
  BlazorApp -> C:UsersdarothDesktopBlazorAppbinDebugnet7.0BlazorApp.dll
dotnet watch  Started
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: https://localhost:7148
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5041
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
      Hosting environment: Development
info: Microsoft.Hosting.Lifetime[0]
      Content root path: C:UsersdarothDesktopBlazorApp
dotnet watch  File changed: .PagesIndex.razor.
dotnet watch  Hot reload of changes succeeded.
info: Microsoft.Hosting.Lifetime[0]
      Application is shutting down...
dotnet watch  Shutdown requested. Press Ctrl+C again to force exit.

通过将 DOTNET_WATCH_RESTART_ON_RUDE_EDIT 环境变量设置为 true，将 dotnet watch 配置为始终在不提示粗鲁编辑（无法热重新加载的编辑）的情况下重新启动。

您现在可以将服务注入 Blazor 中的自定义验证属性。 Blazor 将设置 ValidationContext，以便它可以用作服务提供者。

public class SaladChefValidatorAttribute : ValidationAttribute
{
    protected override ValidationResult IsValid(object value, ValidationContext validationContext)
    {
        var saladChef = validationContext.GetRequiredService<SaladChef>();
        if (saladChef.ThingsYouCanPutInASalad.Contains(value.ToString()))
        {
            return ValidationResult.Success;
        }
        return new ValidationResult("You should not put that in a salad!");
    }
}

// Simple class configured as a service for dependency injection
public class SaladChef
{
    public string[] ThingsYouCanPutInASalad = { "Strawberries", "Pineapple", "Honeydew", "Watermelon", "Grapes" };
}

感谢@MariovanZeist 的贡献！

我们对 HTTP/2 和 HTTP/3 的标头解析和写入性能进行了多项改进。有关详细信息，请参阅以下拉取请求：

gRPC JSON 转码允许 gRPC 服务像 RESTful HTTP API 一样使用。配置完成后，gRPC JSON 转码允许您使用熟悉的 HTTP 概念调用 gRPC 方法：