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 le plus petit ensemble de références qui correspond à la tâche. Ne chargez pas toutes les références par défaut.

Flux de travail

1. Confirmez le 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 actifs statiques.
4. Ouvrez exactement une référence de modèle d'application primaire :
   • references/ui-blazor.md
   • references/ui-razor-pages.md
   • references/ui-mvc.md
   • references/apis-minimal-and-controllers.md
5. Ajoutez les références transversales uniquement selon les besoins :
   • 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 les 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 référentiel ou la demande de l'utilisateur épingle une cible plus ancienne.
• À partir de mars 2026, préférez .NET 10 / ASP.NET Core 10 pour les nouveaux travaux de production. Traitez ASP.NET Core 11 comme une aperçu sauf si l'utilisateur demande explicitement les fonctionnalités d'aperçu.
• 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 concerne la migration.
• Préférez l'injection de dépendances intégrée, les options/configuration, la journalisation, ProblemDetails, OpenAPI, les contrôles de santé, la limitation de débit, la mise en cache de sortie et Identity avant d'ajouter une infrastructure tierce.
• Gardez les tranches de fonctionnalités cohérentes pour que la page, le composant, le point de terminaison, le contrôleur, la validation, le service, l'accès aux données et les tests soient faciles à tracer.
• Respectez le modèle d'application existant. Ne réécrivez pas 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 modèle.
• references/program-and-pipeline.md : Structurez Program.cs, les services, les middlewares, le routage, la configuration, la journalisation et les actifs statiques.
• references/ui-blazor.md : Créez des applications Web Blazor, choisissez les modes de rendu et utilisez les composants, les formulaires et l'interopérabilité JS correctement.
• references/ui-razor-pages.md : Créez des applications centrées sur les pages et rendues côté serveur avec des gestionnaires, la liaison de modèles et des conventions.
• references/ui-mvc.md : Créez des applications contrôleur/vue avec une séparation claire des préoccupations.
• references/apis-minimal-and-controllers.md : Créez des API HTTP avec Minimal APIs ou des contrôleurs, y compris 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 conseils sur l'authentification, l'autorisation, Identity, les secrets, la 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 les tests d'intégration, les tests de navigateur, la mise en cache, la compression, les contrôles de santé, les limites de débit et les préoccupations de déploiement.
• references/versioning-and-upgrades.md : Gérez les frameworks cibles, les changements radicaux, les API 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 modèle 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 mauvais usages du framework ou les modèles obsolètes.
• Quand une tâche mentionne « latest », vérifiez la fonctionnalité sur Microsoft Learn ou le référentiel de docs ASP.NET Core avant de vous fier à la mémoire.