C# Academy · レッスン

出力キャッシュの基本

Q: 「出力キャッシュの基本」で何を学びますか？

レスポンスをキャッシュして処理量を減らします。 ブラウザで直接実行するハンズオンコードでC# Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

レスポンスをキャッシュして処理量を減らします。

「出力キャッシュの基本」はCoddyKit上の無料C# Academyレッスンです。これはレッスン3/4です。下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。これはC# Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 C# Academyコースには全4レッスンが含まれています。

出力キャッシュとは

出力キャッシュは、エンドポイントの完全な HTTP レスポンスを保存します。繰り返し行われるリクエストには、ハンドラーを再実行せずにキャッシュからレスポンスを返すため、読み取り中心のエンドポイントで待機時間と負荷を大幅に削減できます。

// First call -> handler runs, response stored
// Next calls -> response served from cache

出力キャッシュとレスポンスキャッシュの違い

組み込みの出力キャッシュ（.NET 7 で追加）はレスポンスをサーバーに保存し、その動作を完全に制御できます。以前からあるレスポンスキャッシュは HTTP キャッシュヘッダーを付加するだけで、クライアントやプロキシがそれに従うことを前提とします。

// Output caching: server-side store you control
// Response caching: just Cache-Control headers

AddOutputCache

AddOutputCache でサービスを登録します。

builder.Services.AddOutputCache();

UseOutputCache

UseOutputCache でミドルウェアをパイプラインに追加します。ルーティングの後、CORS がある場合は CORS の後に配置します。

var app = builder.Build();

app.UseOutputCache();

app.MapControllers();

エンドポイントでの CacheOutput

CacheOutput（Minimal API）または [OutputCache] 属性（コントローラー）を使って、エンドポイントをキャッシュ対象にします。

app.MapGet("/products", GetProducts)
   .CacheOutput();

// Controller:
// [OutputCache]
// public IActionResult Get() => Ok(...);

有効期限の設定

Expire を使って、レスポンスをキャッシュに保持する期間を制御します。

app.MapGet("/products", GetProducts)
   .CacheOutput(policy => policy.Expire(TimeSpan.FromSeconds(30)));

キャッシュされる対象

デフォルトでは、ステータスコードが 200 の GET および HEAD リクエストだけがキャッシュされます。また、Set-Cookie や認証情報が関係しない場合に限られます。認証済みユーザー向けのレスポンスやユーザー固有のレスポンスを誤ってキャッシュすると危険です。

// Cached by default: GET/HEAD, 200, no cookies/auth

クエリ文字列による Vary

同じパスに対するリクエストでも、クエリ文字列が異なる場合は通常、別々にキャッシュする必要があります。SetVaryByQuery を使用します。

app.MapGet("/search", Search)
   .CacheOutput(policy => policy
        .Expire(TimeSpan.FromSeconds(60))
        .SetVaryByQuery("q", "page"));

ヘッダーによる Vary

ヘッダーによってキャッシュキーを変えることができます。たとえば、Accept-Language ごとに異なるキャッシュコピーを返せます。

policy.SetVaryByHeader("Accept-Language");

すべてに適用する基本ポリシー

AddBasePolicy はすべてのエンドポイントにデフォルト設定を適用します。個々のエンドポイントでは、その設定を引き続き上書きできます。

builder.Services.AddOutputCache(options =>
{
    options.AddBasePolicy(policy =>
        policy.Expire(TimeSpan.FromSeconds(10)));
});

エンドポイントでの無効化

基本ポリシーですべてをキャッシュする場合は、NoCache を使って動的なエンドポイントを除外します。

app.MapGet("/cart", GetCart)
   .CacheOutput(policy => policy.NoCache());

理解度チェック

2 つのキャッシュ機能の違いを確認しましょう。

まとめ

出力キャッシュの基本を学びました。

AddOutputCache と UseOutputCache でサーバー側のキャッシュを有効にします。
CacheOutput / [OutputCache] でエンドポイントをキャッシュ対象にし、Expire で期間を設定します。
デフォルトでは、認証情報や Cookie を含まない GET/HEAD の 200 レスポンスだけがキャッシュされます。
SetVaryByQuery と SetVaryByHeader でキャッシュキーを決めます。

次は、キャッシュポリシーと無効化について学びます。

よくある質問

「出力キャッシュの基本」レッスンは無料ですか？

はい。「出力キャッシュの基本」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、C# Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 C# Academyコースには全4レッスンが含まれています。

「出力キャッシュの基本」で何を学びますか？

レスポンスをキャッシュして処理量を減らします。ブラウザで直接実行するハンズオンコードでC# Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

C# Academyを始めるのに経験は必要ですか？

事前経験は必要ありません。CoddyKitのC# Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。これはレッスン3/4です。

「出力キャッシュの基本」レッスンにはどのくらい時間がかかりますか？

ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。

このC# Academyレッスンでコードを書いて実行できますか？

はい。すべてのC# Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

← C# Academyに戻る