aspnet-core

ASP.NET Core

概要

適切な ASP.NET Core アプリケーションモデルを選び、ホストとリクエストパイプラインを正しく構成し、現在 Microsoft がドキュメントで案内しているフレームワークのスタイルに沿って機能を実装します。

タスクに適した、最小限のリファレンスだけを読み込みます。既定でリファレンスをすべて読み込まないでください。

ワークフロー

1. ターゲットフレームワーク、SDK、現在のアプリケーションモデルを確認します。
2. 新しいアプリや大規模なリファクタリングでは、まず references/stack-selection.md を開きます。
3. 次に、Program.cs、DI、構成、ミドルウェア、ルーティング、ロギング、静的アセットについて、references/program-and-pipeline.md を開きます。
4. アプリケーションモデルに関する主要なリファレンスを、次の中から1つだけ開きます。
   • 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 API またはコントローラーを使った 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 の docs リポジトリで機能を確認します。