ASP.NET Core

Aperçu

Choisissez le bon modèle d'application ASP.NET Core, composez correctement l'hôte et le pipeline de requêtes, et implémentez les fonctionnalités selon le style documenté par Microsoft aujourd'hui.

Chargez l'ensemble minimal de références qui convient à la tâche. Ne chargez pas toutes les références par défaut.

Flux de travail

1. Confirmez la framework cible, le SDK et le modèle d'application actuel.
2. Ouvrez d'abord references/stack-selection.md pour les nouvelles applications ou les refactorisations majeures.
3. Ouvrez ensuite references/program-and-pipeline.md pour Program.cs, l'injection de dépendances, la configuration, les middlewares, le routage, la journalisation et les ressources statiques.
4. Ouvrez exactement une référence primaire de modèle d'application :
   • references/ui-blazor.md
   • references/ui-razor-pages.md
   • references/ui-mvc.md
   • references/apis-minimal-and-controllers.md
5. Ajoutez des références transversales uniquement si nécessaire :
   • 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. Ouvrez references/versioning-and-upgrades.md avant d'introduire de nouvelles API de plateforme dans une solution plus ancienne ou lors de la migration entre versions majeures.
7. Utilisez references/source-map.md quand vous avez besoin de la section Microsoft Learn qui correspond à une tâche non encore couverte par les références ciblées.

Hypothèses opérationnelles par défaut

• Préférez la dernière version stable d'ASP.NET Core et .NET sauf si le repository ou la demande utilisateur fixe une cible plus ancienne.
• Depuis mars 2026, préférez .NET 10 / ASP.NET Core 10 pour les nouveaux travaux en production. Considérez ASP.NET Core 11 comme preview sauf si l'utilisateur demande explicitement les fonctionnalités preview.
• Préférez WebApplicationBuilder et WebApplication. Évitez les anciens modèles Startup et WebHost sauf si la base de code les utilise déjà ou si la tâche est une migration.
• Préférez l'injection de dépendances intégrée, les options/configuration, la journalisation, ProblemDetails, OpenAPI, les health checks, la limitation de débit, la mise en cache des sorties et Identity avant d'ajouter une infrastructure tierce.
• Gardez les tranches de fonctionnalités cohésives afin que la page, le composant, l'endpoint, le contrôleur, la validation, le service, l'accès aux données et les tests soient faciles à retracer.
• Respectez le modèle d'application existant. Ne réécrivez pas les Razor Pages en MVC ou les contrôleurs en Minimal APIs sans une raison claire.

Guide de référence

• references/_sections.md : Index rapide et ordre de lecture.
• references/stack-selection.md : Choisissez le bon modèle d'application ASP.NET Core et le bon template.
• references/program-and-pipeline.md : Structurez Program.cs, les services, les middlewares, le routage, la configuration, la journalisation et les ressources statiques.
• references/ui-blazor.md : Créez des Blazor Web Apps, choisissez les modes de rendu et utilisez correctement les composants, formulaires et JS interop.
• references/ui-razor-pages.md : Créez des applications server-rendered centrées sur les pages avec des handlers, la liaison de modèles et les conventions.
• references/ui-mvc.md : Créez des applications contrôleur/vue avec une séparation claire des responsabilités.
• references/apis-minimal-and-controllers.md : Créez des HTTP APIs avec Minimal APIs ou des contrôleurs, incluant la validation et les modèles de réponse.
• references/data-state-and-services.md : Utilisez EF Core, DbContext, les options, IHttpClientFactory, la session, les données temporaires et l'état de l'application de manière responsable.
• references/security-and-identity.md : Appliquez les directives d'authentification, autorisation, Identity, secrets, protection des données, CORS, CSRF et HTTPS.
• references/realtime-grpc-and-background-work.md : Utilisez SignalR, gRPC et les services hébergés.
• references/testing-performance-and-operations.md : Ajoutez des tests d'intégration, des tests de navigateur, la mise en cache, la compression, les health checks, les limites de débit et les préoccupations de déploiement.
• references/versioning-and-upgrades.md : Gérez les frameworks cibles, les breaking changes, les APIs obsolètes et les migrations.
• references/source-map.md : Mappez l'arborescence officielle de la documentation ASP.NET Core aux références de cette compétence.

Notes d'exécution

• Lors de la génération de nouveau code, commencez par le bon template dotnet new et gardez la structure générée reconnaissable.
• Lors de la modification d'une solution existante, suivez d'abord les conventions de la solution et utilisez ces références pour éviter les mauvaises pratiques du framework ou les modèles obsolètes.
• Quand une tâche mentionne « latest », vérifiez la fonctionnalité sur Microsoft Learn ou le repository de la documentation ASP.NET Core avant de vous fier à la mémoire.