ASP.NET Core はじめの一歩 | 日本語版 ASP.NET Core ステップアップチュートリアル

ASP.NET Core はじめの一歩最初のエンドポイントから本番公開まで

プログラミング経験はあるけれど、C# は初めてという方へ。.NET 10 と Minimal API を使い、一度に一つの概念を学びます。各章はそのまま dotnet run できる完成したプロジェクトです。

1ページにつき1つの概念

各ページの冒頭で完成形のコードを示し、続けて部分ごとに解説します。この章で追加した箇所は行単位でハイライトするので、新しい用語を一度に詰め込みません。

コードはすべてそのまま実行可能

チュートリアルのコードはすべて、リポジトリ内の実際のサンプルプロジェクトから引用しています。CI ではコミットのたびにすべてのサンプルをビルドします。コピーして dotnet run するだけで動き、「ここは省略」といった箇所はありません。

「なぜ」まで説明

書き方だけでなく、フレームワークがそのように設計されている理由も解説します。なぜ builder と app が分かれているのか、なぜルートは登録順で判定されないのか、といった疑問に答えます。

FastAPI との対比

FastAPI を使ったことがある方に向けて、重要な概念ごとに類似点を簡潔に説明し、これまでの経験を活かせるようにします。

型システムを活用

C# の静的型付けを活かして、エディター補完、コンパイル時のエラー検出、自動生成される OpenAPI ドキュメントを、同じコードから実現します。

本番公開まで学べる

ルーティング、検証、依存性注入、EF Core + SQLite、JWT 認証、テスト、Docker デプロイを学び、読み終えるころには API を一通り自力で作れるようになります。

Web API の完成形はわずか17行

これは第02章の終わりに作るプログラムです。JSON を返すエンドポイントと、自動生成される対話型 API ドキュメントが含まれます。変更が必要な設定ファイルも、継承するひな形クラスもありません。

プロジェクトを作成dotnet new web を1回実行するだけで、最小構成の Web プロジェクトができます
エンドポイントを宣言MapGet で URL と通常の関数を結び付けます。戻り値は自動的に JSON にシリアライズされます
実行dotnet watch でサーバーを起動します。コードを変更すると自動でホットリロードされます
ドキュメントを開く/scalar にアクセスし、ブラウザーからエンドポイントを直接テストできます

Program.cs

using Scalar.AspNetCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddOpenApi();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.MapOpenApi();
    app.MapScalarApiReference();
}

app.MapGet("/", () => new { Message = "Hello, ASP.NET Core!" });

app.Run();

6つの段階を一つの流れで

後の章は前の章の内容を前提としています。たとえば EF Core では依存性注入を使い、認証ではミドルウェアを使います。そのため、チュートリアルは順序立てた構成です。順番に読むことをおすすめします。

ASP.NET Core はじめの一歩最初のエンドポイントから本番公開まで

1ページにつき1つの概念

コードはすべてそのまま実行可能

「なぜ」まで説明

FastAPI との対比

型システムを活用

本番公開まで学べる

Web API の完成形はわずか17行

6つの段階を一つの流れで

入門

リクエストとレスポンス

アプリケーションの基盤

データアクセス

セキュリティ

公開に向けて

ASP.NET Core はじめの一歩最初のエンドポイントから本番公開まで

1ページにつき1つの概念

コードはすべてそのまま実行可能

「なぜ」まで説明

FastAPI との対比

型システムを活用

本番公開まで学べる

Web API の完成形はわずか17行 ​

6つの段階を一つの流れで ​

入門

リクエストとレスポンス

アプリケーションの基盤

データアクセス

セキュリティ

公開に向けて

Web API の完成形はわずか17行

6つの段階を一つの流れで