[大数据] 【译】.NET 7 预览版 1 中的 ASP.NET Core 更新

开发: C++知识库 Java知识库 JavaScript Python PHP知识库人工智能区块链大数据移动开发嵌入式开发工具数据结构与算法开发测试游戏开发网络协议系统运维
教程: HTML教程 CSS教程 JavaScript教程 Go语言教程 JQuery教程 VUE教程 VUE3教程 Bootstrap教程 SQL数据库教程 C语言教程 C++教程 Java教程 Python教程 Python3教程 C#教程
数码: 电脑笔记本显卡显示器固态硬盘硬盘耳机手机 iphone vivo oppo 小米华为单反装机图拉丁

-> 大数据 -> 【译】.NET 7 预览版 1 中的 ASP.NET Core 更新 -> 正文阅读

[大数据]【译】.NET 7 预览版 1 中的 ASP.NET Core 更新

原文 | 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 中的重大更改的完整列表。

最小的 API 改进

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; 
});

SignalR 客户端源生成器

感谢@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<T>(this HubConnection connection, T provider);

    [HubServerProxy]
    public static partial T ServerProxy<T>(this HubConnection connection);
}

使用代码中的部分方法！

public interface IServerHub
{
    Task SendMessage(string message);
    Task<int> 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<IServerHub>();
var registrations = connection.ClientRegistration<IClient>(new Client());

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

支持 MVC 视图和 Razor 页面中的可为空模型

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

@model Product?

在验证错误中使用 JSON 属性名称

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

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

改进了 dotnet watch 的控制台输出

我们清理了 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 配置为始终重新启动以进行粗鲁的编辑

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

将服务注入 Blazor 中的自定义验证属性

您现在可以将服务注入 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 的贡献！