aspnet-core

ASP.NET Core

概述

选择合适的 ASP.NET Core 应用模型，正确组合主机与请求管道，并按照 Microsoft 当前文档描述的框架风格实现功能。

仅加载符合任务需求的最少参考资料。默认不要加载所有参考资料。

工作流

1. 确认目标框架、SDK 和当前应用模型。
2. 对于新应用或重大重构，先打开 references/stack-selection.md。
3. 接着打开 references/program-and-pipeline.md，了解 Program.cs、DI、配置、中间件、路由、日志记录和静态资源。
4. 打开且仅打开一份主要应用模型参考资料：
   • references/ui-blazor.md
   • references/ui-razor-pages.md
   • references/ui-mvc.md
   • references/apis-minimal-and-controllers.md
5. 根据需要添加跨领域参考资料：
   • references/data-state-and-services.md
   • references/security-and-identity.md
   • references/realtime-grpc-and-background-work.md
   • references/testing-performance-and-operations.md
6. 在将新的平台 API 引入旧解决方案，或在主要版本之间迁移时，先打开 references/versioning-and-upgrades.md。
7. 如果需要查找与任务对应、但精简参考资料尚未涵盖的 Microsoft Learn 章节，请使用 references/source-map.md。

默认操作假设

• 除非代码仓库或用户请求指定较旧的目标版本，否则优先使用最新稳定版 ASP.NET Core 和 .NET。
• 截至 2026 年 3 月，新生产项目优先使用 .NET 10 / ASP.NET Core 10。除非用户明确要求预览功能，否则将 ASP.NET Core 11 视为预览版。
• 优先使用 WebApplicationBuilder 和 WebApplication。除非代码库已经使用旧式 Startup 和 WebHost 模式，或任务属于迁移，否则避免使用这些模式。
• 优先采用内置 DI、选项/配置、日志记录、ProblemDetails、OpenAPI、运行状况检查、速率限制、输出缓存和 Identity，再考虑添加第三方基础设施。
• 保持功能切片内聚，确保页面、组件、端点、控制器、验证、服务、数据访问和测试易于追踪。
• 遵循现有应用模型。没有明确理由时，不要将 Razor Pages 重写为 MVC，也不要将控制器改写为 Minimal APIs。

参考指南

• references/_sections.md：快速索引和阅读顺序。
• references/stack-selection.md：选择合适的 ASP.NET Core 应用模型和模板。
• references/program-and-pipeline.md：组织 Program.cs、服务、中间件、路由、配置、日志记录和静态资源。
• references/ui-blazor.md：构建 Blazor Web Apps，选择呈现模式，并正确使用组件、表单和 JS 互操作。
• references/ui-razor-pages.md：使用处理程序、模型绑定和约定构建以页面为中心的服务器端呈现应用。
• references/ui-mvc.md：构建职责分明的控制器/视图应用。
• references/apis-minimal-and-controllers.md：使用 Minimal APIs 或控制器构建 HTTP API，包括验证和响应模式。
• references/data-state-and-services.md：合理使用 EF Core、DbContext、选项、IHttpClientFactory、会话、临时数据和应用状态。
• references/security-and-identity.md：遵循身份验证、授权、Identity、密钥、数据保护、CORS、CSRF 和 HTTPS 指南。
• references/realtime-grpc-and-background-work.md：使用 SignalR、gRPC 和托管服务。
• references/testing-performance-and-operations.md：添加集成测试、浏览器测试、缓存、压缩、运行状况检查、速率限制，并处理部署相关问题。
• references/versioning-and-upgrades.md：处理目标框架、重大变更、已弃用 API 和迁移。
• references/source-map.md：将官方 ASP.NET Core 文档树映射到此技能中的参考资料。

执行说明

• 生成新代码时，从合适的 dotnet new 模板开始，并保持生成的结构易于辨认。
• 编辑现有解决方案时，优先遵循该解决方案的约定，并参考这些资料，避免误用框架或采用过时模式。
• 任务提到“latest”时，请先在 Microsoft Learn 或 ASP.NET Core 文档仓库中核实相关功能，再依据记忆作答。