csdn_aspnet的专栏，请点击博客主页右上角三个点中的私信联系

.NET 9正式发布：关键特性与迁移指南 微软正式推出.NET 9，带来多项重大改进： 性能优化：改进的AOT编译、更快垃圾回收和JIT编译 开发增强：LINQ可视化、AI驱动调试、混合缓存 跨平台支持：Blazor WebAssembly AOT、MAUI增强 迁移建议： 评估兼容性和依赖项 更新开发环境和工具链 重构弃用API 利用新特性优化性能 进行全面测试 .NET 9特别适合云原生开发，支持Kubernetes和微服务部署。迁移过程建议采用渐进式策略，并参考微软官方指南。

SignalR 是一个库，可用于向应用程序添加实时 Web 功能。它提供了一个简单的 API，用于创建可从服务器和客户端调用的服务器到客户端远程过程调用 (RPC)。现在，SignalR 在 .NET 8.0 和 .NET 9.0 中支持修剪和原生 AOT。AOT（提前编译）功能允许您在运行应用程序之前将其编译为原生代码。这有助于提升性能并缩短启动时间。Triming 功能允许您从应用程序中移除未使用的代码，从而减小应用程序大小并提升性能。

ASP.NET Core SignalR在.NET 9中迎来重要更新：1)支持基类多态处理，Hub方法可直接接收基类参数(如Animal)并通过派生类(Cat/Dog)处理；2)增强诊断功能，与OpenTelemetry深度集成，支持在Aspire仪表板监控SignalR事件；3)新增对修剪和原生AOT编译的支持，提升性能，但需注意JSON序列化和返回值类型限制。这些改进使SignalR更强大且更易监控。

NET 9 的新功能为在 Azure 上构建强大的云原生应用程序开辟了难以置信的可能性。借助 Native AOT、HybridCache 和改进的 JSON 处理等优化，您可以设计快速、高效且经济实惠的解决方案。对于那些希望在云中扩展 .NET 应用的人来说，这些更新是探索优化应用程序的新方法的绝佳机会。在下一个 Azure 项目中尝试这些功能，并亲身体验 .NET 9 如何简化云开发。

NET 9 引入了一系列令人兴奋的更新，可提高性能和开发人员的工作效率。凭借本机 AOT 编译、增强的跨平台功能和 C# 12 的改进等强大功能，.NET 9 正逐渐成为现代应用程序开发的必备工具。通过利用这些新功能，您可以构建更快、更安全、可扩展的应用程序。无论您是在优化当前项目还是探索新项目，.NET 9 都旨在让您的开发之旅更顺畅、更高效。继续尝试，并拥抱 .NET 9 的新可能性！

1、轻量、简单、易于阅读。2、允许快速测试端点。3、支持Visual Studio Code中的变量和响应重用。示例：一个简单的 .http 文件Scalar是一个开源 API 平台，它将 API 文档和测试提升到了一个新的水平。它提供了现代功能、直观的用户体验和时尚的界面（为真正的工程师提供暗黑模式！

NET 9 是 Microsoft .NET 生态系统的最新发展，它不断通过新功能和增强功能突破开发界限，旨在提高开发人员的安全性、性能和易用性。无论您是构建企业软件、移动应用程序还是基于云的解决方案，.NET 9 的最新进展都提供了在当今快速发展的开发环境中取得成功所需的工具和功能。开发人员可以利用更快的执行速度、增强的安全机制和更高效的工具来构建现代、可扩展的应用程序。性能：优化的垃圾收集、更快的 JIT 编译和改进的异步 I/O 使 .NET 9 成为该框架性能最高的版本之一。

您可能听说过，Swagger 在 ASP.NET 9 的模板中被删除了。因此，这篇博文将向您展示替代方案。Swagger 是一个基于 Open API 的图形工具，它提供了一个图形界面来交互和测试 API。NSwag 能够提供 Swagger UI，与 Swashbuckle 类似。​相对较新的是：Scalar，它们具有大量集成，当然也适用于 .NET。

本文提供了将 Swagger（通过 Swashbuckle）添加到 .NET 9 Web API 项目的实用步骤，并讨论了从 Web API 模板中删除 Swagger，并提出了 API 文档的替代方案。它首先详细介绍了 Swagger 的历史、它作为标准化 API 文档的开源工具的出现以及 ASP.NET 开发人员的早期采用。总之，本文介绍了 Swagger 在 .NET 生态系统中的历史、演变和未来，以及在 .NET 9 中使用 Swagger 和 Scalar 进行高效 API 文档编写的实用指南。

随着 .NET 9 的发布，微软宣布他们将不再为任何 .NET API 项目提供默认的 Swagger gen UI。以前，当我们创建 .NET API 项目时，微软会自动添加 Swagger Swashbuckle 包，该包提供了app.UseSwagger()和app.UseSwaggerUI() 等方法。这些方法显示了带有预定义 UI 的 API 文档，可直接在浏览器中进行测试，而无需使用 Postman 等任何第三方应用程序。但是，Swagger 不再与 .NET 9 Web API 项目集成。

Scalar 是一款可帮助我们为 API 创建精美文档的工具。与感觉有些过时的默认 Swagger 文档不同，Scalar 为 API 文档提供了全新而现代的 UI。其简洁的设计让开发人员可以轻松找到测试所需的 API。在本文中，我们将探讨如何在 ASP.NET Core Web API 中使用 Scalar 进行 API 文档编写以替换默认的 Swagger UI。

微软已经放弃了对 .NET 9 中 Swagger UI 包 Swashbuckle 的支持。该项目“不再由社区所有者积极维护”并且“问题尚未得到解决”。这意味着当您使用 .NET 9 模板创建 Web API 时，您将不再拥有 UI 来测试您的 API 端点。我们将调查是否可以在 .NET 9 中使用 Swagger UI 以及是否有更好的替代方案。无论您使用 Visual Studio 创建 .NET 8 还是 .NET 9 Web API，您都可以选择启用 OpenAPI 支持。

借助 .NET 9，ASP.NET Core 现在内置了对基于控制器和最小 API 生成 OpenAPI 文档的支持，这要归功于 Microsoft.AspNetCore.OpenApi 包。在本文中，我们将深入探讨微软在 .NET 9 中引入的开放 API 支持。我们已经准备好了所需的设置。这意味着当您使用 .NET 9 模板创建 Web API 时，您将不再拥有 UI 来测试您的 API 端点。下面的代码更新了文档的描述，将授权标头标记为必需，并添加了一个额外的服务器作为文档的一部分。

.Net6.0.Net7.0.Net8.0.Net9.0使用Serilog按日志等级写入日志及appsetting.json配置方式实现。最近使用最新版的Serilog记录日志时，发现以前有些关于Serilog的Nuget弃用了，最关键的是有些配置写法也改变，于是就整理了一下最新版的Serilog配置方式(appsetting.json)的使用说明：我是用的.Net6，最新长期支持版到.Net8了，不过Serilog我用的是最新版，配置方式都一样。

微软表示，.NET 9 是迄今为止性能最高的 .NET 版本，对运行时、工作负载和语言方面进行了 1,000 多项与性能相关的改进，并采用了更高效的算法来生成更好的代码。.NET 9 是 .NET 8 的继任者，特别侧重于云原生应用和性能。如果你是第一次发布，这里可以不勾选，如果已经发布过，这里不勾选，可能会影响程序发布（注意：正式环境上不要使用此方式，可能会带来严重后果。至此，.Net 9.0 Webapi 项目发布完成，希望本文对你有帮助。本文发布没有报错误和异常，一次发布成功通过。

.NET 8.0 项目升级到 .NET 9.0，发现AutoMapper-v13.0.1正常，AutoMapper.Extensions.Microsoft.DependencyInjection-v12.0.1已弃用，将AutoMapper和AutoMapper.Extensions.Microsoft.DependencyInjection版本都降至12.0.0版本后，异常消除.可能因为之前项目内的AutoMapper-v13.0.1语法不支持。选择相应程序包-右侧选择版本，点击更新即可。

因此，是否更新到 .NET 8 或 .NET 9 确实取决于您的情况。此外，如果您使用的是 .NET 8，则需要更新在版本 8 上运行的任何 Microsoft NuGet 包，或者与您正在使用的 .NET 版本相对应的任何版本。如果您的应用程序使用的是 .NET 7 或 .NET 6 以下的任何版本，那么您应该进行更新，因为这些版本不久前已经过期。在 .NET 8 中，如果您注入了一个未作为依赖注入的一部分注册的键控服务，但是您有一个具有相同接口的非键控服务，则该非键控服务将被解析。但你为什么要更新呢？

然而，它实际上只是删除了部分和侧边栏，而没有改变 UI 的任何其他部分，所以我没有发现删除有什么好处。有趣的是，除了默认主题之外，我们还有一个None主题。好吧，将它们并排摆在一起，我可以向你保证，这是最黑的主题，所以如果你想要最大的对比度，这就是你的选择！在我看来，该主题看起来比 Swagger UI 更酷、更现代，但当然，继续使用默认主题是很无聊的，让我们研究一下还有什么。这个主题也很有启发性，符合我的标准，既要花哨又要专业。嗯，又是一个蓝色主题，但颜色要深得多，我个人更喜欢这个。

NET 9 的 AOT 支持无疑拓宽了.NET 生态的应用范围，为那些需要在老旧平台上运行高性能应用的开发者提供了强大的工具。随着技术的发展，我们期待未来更多的.NET 版本能够进一步打破界限，让编程变得更加灵活和高效。GSD及M$達分享的这个好消息，大石头这篇文章《各版本操作系统对.NET 支持情况》推荐大家阅读：https://newlifex.com/tech/os_net参考AOT项目：https://github.com/dotnet9/CodeWF.Toolbox。

.NET 9 支持的操作系统版本，例如 Debian 12、Ubuntu 22.04 及更高版本。主要通过 libc 版本定义最低兼容性。对以下操作系统版本的支持已结束。不受支持的操作系统版本。