ASP.NET Core Blazor のレンダーモード

[アーティクル]
06/21/2024

この記事では、コンパイル時または実行時の Blazor Web App での Razor コンポーネントのレンダリングの制御について説明します。

このガイダンスは、スタンドアロン Blazor WebAssembly アプリには適用されません。 Blazor WebAssembly アプリは、クライアント側の WebAssembly ベースのランタイムを介してクライアント上でレンダリングのみを行い、レンダリングモードの概念はありません。レンダリングモードが Blazor WebAssembly アプリのコンポーネントに適用されている場合、レンダリングモードの指定はコンポーネントのレンダリングに影響しません。

レンダーモード

Blazor Web App のすべてのコンポーネントは、レンダーモードを採用して、使用するホスティングモデル、レンダリング場所、対話型かどうかを判断します。

次の表は、Blazor Web App で Razor コンポーネントをレンダリングするために使用できるレンダーモードを示しています。コンポーネントにレンダリングモードを適用するには、コンポーネントインスタンスまたはコンポーネント定義で @rendermode ディレクティブを使います。この記事の後半では、レンダーモードのシナリオごとに例を示します。

名前	説明	レンダーの場所	Interactive
静的サーバー	静的サーバー側レンダリング (静的 SSR)	[サーバー]	いいえ
対話型サーバー	Blazor Server を使用した対話型サーバー側レンダリング (対話型 SSR)。	[サーバー]	はい
対話型 WebAssembly	Blazor WebAssembly を使用したクライアント側レンダリング (CSR)†。	クライアント	はい
対話型自動	最初に Blazor Server、その後 Blazor バンドルのダウンロード後の後続のアクセスに CSR を使用する、対話型 SSR。	サーバー、その後クライアント	はい

†クライアント側レンダリング (CSR) は対話型と見なされます。 ""対話型" クライアント側レンダリング" と ""対話型" CSR" は業界や Blazor のドキュメントでは使用されません。

対話型コンポーネントではプリレンダリングが既定で有効になっています。プリレンダリングの制御に関するガイダンスについては、この記事の後半で説明します。クライアントとサーバーのレンダリングの概念に関する一般的な業界用語については、「ASP.NET Core Blazor の基礎」をご覧ください。

次の例では、いくつかの基本的な Razor コンポーネント機能を使用してコンポーネントのレンダーモードを設定する方法を示します。

レンダーモードの動作をローカルでテストするには、Blazor Web App プロジェクトテンプレートから作成されたアプリに次のコンポーネントを配置します。アプリを作成するときに、ドロップダウンメニューからオプション (Visual Studio) を選択するか、CLI オプション (.NET CLI) を適用して、サーバー側とクライアント側の両方のインタラクティビティを有効にします。 Blazor Web App の作成方法に関するガイダンスについては、「ASP.NET Core Blazor 用のツール」を参照してください。

対話型レンダーモードのサポートを有効にする

Blazor Web App は、対話型レンダーモードをサポートするように構成する必要があります。次の拡張機能は、アプリの作成時に Blazor Web App プロジェクトテンプレートから作成されたアプリに対して自動的に適用されます。個々のコンポーネントは、アプリの Program ファイルでコンポーネントサービスとエンドポイントを構成した後、「レンダーモード」セクションに従ってレンダーモードを宣言する必要があります。

Razor コンポーネントのサービスは、AddRazorComponents を呼び出すことによって追加されます。

コンポーネントビルダー拡張機能:

AddInteractiveServerComponents によって、対話型サーバーコンポーネントのレンダリングをサポートするサービスが追加されます。
AddInteractiveWebAssemblyComponents によって、対話型 WebAssembly コンポーネントのレンダリングをサポートするサービスが追加されます。

MapRazorComponents は使用可能なコンポーネントを検出し、アプリのルートコンポーネント (読み込む最初のコンポーネント) を特定します。これは既定では App コンポーネント (App.razor) です。

エンドポイント規則ビルダー拡張機能:

AddInteractiveServerRenderMode では、アプリの対話型サーバー側レンダリング (対話型 SSR) を構成します。
AddInteractiveWebAssemblyRenderMode では、アプリの対話型 WebAssembly レンダリングモードを構成します。

Note

次の例での API の配置に関する説明については、Blazor Web App プロジェクトテンプレートから生成されたアプリの Program ファイルを調べてください。 Blazor Web App の作成方法に関するガイダンスについては、「ASP.NET Core Blazor 用のツール」を参照してください。

例 1: 次の Program ファイルの API は、対話型 SSR を有効にするためのサービスと構成を追加します。

builder.Services.AddRazorComponents()
    .AddInteractiveServerComponents();

app.MapRazorComponents<App>()
    .AddInteractiveServerRenderMode();

例 2: 次の Program ファイルの API は、対話型 WebAssembly レンダリングモードを有効にするためのサービスと構成を追加します。

builder.Services.AddRazorComponents()
    .AddInteractiveWebAssemblyComponents();

app.MapRazorComponents<App>()
    .AddInteractiveWebAssemblyRenderMode();

例 3: 次の Program ファイルの API は、対話型サーバー、対話型 WebAssembly、対話型自動レンダリングモードを有効にするためのサービスと構成を追加します。

builder.Services.AddRazorComponents()
    .AddInteractiveServerComponents()
    .AddInteractiveWebAssemblyComponents();

app.MapRazorComponents<App>()
    .AddInteractiveServerRenderMode()
    .AddInteractiveWebAssemblyRenderMode();

Blazor は、Blazor WebAssembly ホスティングモデルを使用して、対話型 WebAssembly レンダリングモードを使用するコンポーネントをダウンロードして実行します。これらのコンポーネントの Blazor WebAssembly ホスティングを設定するには、別のクライアントプロジェクトが必要です。クライアントプロジェクトには、Blazor WebAssembly ホストのスタートアップコードが含まれており、ブラウザーで実行するための .NET ランタイムを設定します。 Blazor Web App テンプレートでは、WebAssembly のインタラクティビティを有効にするオプションを選択すると、このクライアントプロジェクトが自動的に追加されます。対話型 WebAssembly レンダリングモードを使用するコンポーネントは、クライアントプロジェクトからビルドする必要があるため、ダウンロードしたアプリバンドルに含められます。

コンポーネントインスタンスにレンダーモードを適用する

コンポーネントインスタンスにレンダーモードを適用するには、コンポーネントが使用される場所の @rendermodeRazor ディレクティブ属性を使用します。

次の例では、対話型サーバー側レンダリング (対話型 SSR) が Dialog コンポーネントインスタンスに適用されます。

<Dialog @rendermode="InteractiveServer" />

Note

Blazor テンプレートには、より短い @rendermode 構文のためにアプリの _Imports ファイル (Components/_Imports.razor) の RenderMode の静的 using ディレクティブが含まれています。

@using static Microsoft.AspNetCore.Components.Web.RenderMode

上のディレクティブがない場合、コンポーネントは @rendermode 構文で静的な RenderMode クラスを指定する必要があります。

<Dialog @rendermode="RenderMode.InteractiveServer" />

また、カスタムの構成で直接インスタンス化されたカスタムレンダリングモードインスタンスを参照することもできます。詳しくは、この記事で後述する「カスタムの短縮形レンダリングモード」セクションをご覧ください。

コンポーネント定義にレンダーモードを適用する

コンポーネントのレンダーモードを定義の一部として指定するには、@rendermodeRazor ディレクティブとそれに対応するレンダーモード属性を使用します。

@page "..."
@rendermode InteractiveServer

コンポーネント定義にレンダーモードを適用することは、特定のページにレンダーモードを適用するときによく使用されます。ルーティング可能なページは、既定で、そのページをレンダリングした Router コンポーネントと同じレンダーモードを使用します。

技術的には、@rendermode は Razor "ディレクティブ" であり、Razor "ディレクティブ属性" でもあります。セマンティクスは似ていますが、違いがあります。 @rendermode ディレクティブはコンポーネント定義に対するものなので、参照されるレンダリングモードインスタンスは静的である必要があります。 @rendermode ディレクティブ属性は、任意のレンダリングモードインスタンスを受け取ることができます。

Note

コンポーネント作成者は、コンポーネントの実装を特定のレンダーモードに結合しないようにする必要があります。代わりに、コンポーネント作成者は通常、任意のレンダーモードまたはホスティングモデルをサポートするようにコンポーネントを設計する必要があります。コンポーネントの実装では、実行されている場所 (サーバーまたはクライアント) に関する想定を回避し、静的にレンダリングするときは適切に品質を下げる必要があります。コンポーネントが直接インスタンス化されていない場合 (ルーティング可能なページコンポーネントなど)、またはすべてのコンポーネントインスタンスのレンダーモードを指定する場合は、コンポーネント定義でレンダーモードを指定することが必要になる場合があります。

アプリ全体にレンダリングモードを適用する

アプリ全体のレンダリングモードを設定するには、アプリのコンポーネント階層の、ルートコンポーネントではない最上位の対話型コンポーネントで、レンダリングモードを指定します。

Note

ルートコンポーネントを対話型にすること (App コンポーネントなど) はサポートされていません。そのため、アプリ全体のレンダリングモードを App コンポーネントで直接設定することはできません。

Blazor Web App プロジェクトテンプレートに基づくアプリの場合、アプリ全体に割り当てられるレンダリングモードは、通常、App コンポーネント (Components/App.razor) で Routes コンポーネントが使われる場所で指定されます。

<Routes @rendermode="InteractiveServer" />

Router コンポーネントは、ルーティングするページに自身のレンダーモードを伝達します。

また、通常は、HeadOutlet コンポーネントで同じインタラクティブレンダーモードを設定する必要があります。これは、プロジェクトテンプレートから生成された Blazor Web App の App コンポーネントにも含まれます。

<HeadOutlet @rendermode="InteractiveServer" />

対話型クライアント側 (WebAssembly または自動) レンダリングモードを採用し、Routes コンポーネントを介してアプリ全体でレンダリングモードを有効にするアプリの場合:

サーバーアプリの Components/Layout フォルダーにあるレイアウトファイルとナビゲーションファイルを、.Client プロジェクトの Layout フォルダーに配置または移動します。 .Client プロジェクトに Layout フォルダーが存在しない場合は作成します。
サーバーアプリの Components/Pages フォルダーにあるコンポーネントを、.Client プロジェクトの Pages フォルダーに配置または移動します。 .Client プロジェクトに Pages フォルダーが存在しない場合は作成します。
サーバーアプリの Components フォルダーにある Routes コンポーネントを、.Client プロジェクトのルートフォルダーに配置または移動します。

Blazor Web App の作成時にグローバルな対話機能を有効にするには:

Visual Studio: [Interactivity location] (対話機能の場所) ドロップダウンリストを [グローバル] に設定します。
.NET CLI: -ai|--all-interactive オプションを使います。

詳しくは、「ASP.NET Core Blazor 用のツール」をご覧ください。

プログラムでレンダリングモードを適用する

プロパティとフィールドで、レンダーモードを割り当てることができます。

このセクションで説明する 2 つ目のアプローチでは、コンポーネントインスタンスごとにレンダリングモードを設定します。これは、グローバル対話型アプリで 1 つ以上のコンポーネントに静的 SSR を採用する必要があるアプリ仕様の場合に特に便利です。このシナリオについては、この記事の後半の「グローバル対話型アプリの静的 SSR ページ」セクションで取り上げます。

コンポーネント定義でレンダーモードを設定する

コンポーネントの定義では、プライベートフィールドを使ってレンダリングモードを定義できます。

@rendermode pageRenderMode

...

@code {
    private static IComponentRenderMode pageRenderMode = InteractiveServer;
}

コンポーネントインスタンスでレンダーモードを設定する

次の例では、すべての要求に対して対話型サーバー側レンダリング (対話型 SSR) を適用しています。

<Routes @rendermode="PageRenderMode" />

...

@code {
    private IComponentRenderMode? PageRenderMode => InteractiveServer;
}

レンダリングモードの伝達について詳しくは、この記事の後半の「レンダーモードの伝達」セクションをご覧ください。「グローバル対話型アプリの静的 SSR ページ」セクションでは、前のアプローチを使用してグローバル対話型アプリで静的 SSR を採用する方法を示しています。

実行時にレンダリングの場所、対話機能、および割り当てられたレンダリングモードを検出する

ComponentBase.RendererInfo と ComponentBase.AssignedRenderMode プロパティを使用すると、アプリはコンポーネントの場所、対話機能、および割り当てられたレンダリングモードに関する詳細を検出できます。

RendererInfo.Name は、コンポーネントが実行されている場所を返します。
- Static: サーバー (SSR) 上にあり、対話はできません。
- Server: サーバー (SSR) 上にあり、プリレンダリング後に対話できます。
- WebAssembly: クライアント (CSR) 上にあり、プリレンダリング後に対話できます。
- WebView: ネイティブデバイス上にあり、プリレンダリング後に対話できます。
RendererInfo.IsInteractive は、レンダリング時にコンポーネントが対話機能をサポートしているかどうかを示します。値は、対話的にレンダリングする場合は true、プリレンダリングまたは静的 SSR (Platform.Name が Static) の場合は false になります。
ComponentBase.AssignedRenderMode は、コンポーネントの割り当てられたレンダリングモードを公開します。
- Interactive Server の場合 InteractiveServer。
- Interactive Auto の場合 InteractiveAuto。
- Interactive WebAssembly の場合 InteractiveWebAssembly。

コンポーネントは、これらのプロパティを使用して、場所や対話機能の状態に応じてコンテンツをレンダリングします。たとえば、プリレンダリング中にフォームを無効にし、コンポーネントが対話型になったときに有効にすることができます。

<EditForm Model="Movie" ...>
    <fieldset disabled="@disabled">

        ...

        <button type="submit" >Save</button>
    </fieldset>
</EditForm>

@code {
    private bool disabled = true;

    [SupplyParameterFromForm]
    private Movie? Movie { get; set; }

    protected override async Task OnInitializedAsync()
    {
        Movie ??= await ...;

        if (RendererInfo.IsInteractive)
        {
            disabled = false;
        }
    }
}

次の例では、コンポーネントが静的にレンダリングされる場合に、通常の HTML アクションの実行をサポートするようにマークアップをレンダリングする方法を示します。

@if (AssignedRenderMode is null)
{
    // The render mode is Static Server
    <form action="/movies">
        <input type="text" name="titleFilter" />
        <input type="submit" value="Search" />
    </form>
}
else
{
    // The render mode is Interactive Server, WebAssembly, or Auto
    <input @bind="titleFilter" />
    <button @onclick="FilterMovies">Search</button>
}

前の例の場合:

AssignedRenderMode の値が null の場合、コンポーネントは静的 SSR を採用します。 Blazor イベント処理は、静的 SSR を使用するブラウザーでは機能しないため、コンポーネントは、ユーザーの <input> 値に設定された titleFilter クエリ文字列を含むフォーム (GET 要求) を送信します。 Movie コンポーネント (/movie) は、クエリ文字列を読み取り、titleFilter の値を処理して、フィルター処理された結果でコンポーネントをレンダリングできます。
それ以外の場合、レンダリングモードは、InteractiveServer、InteractiveWebAssembly、または InteractiveAuto のいずれかです。コンポーネントは、イベントハンドラーデリゲート (FilterMovies) と <input> 要素 (titleFilter) にバインドされた値を使用して、バックグラウンド SignalR 接続経由でムービーを対話的にフィルター処理できます。

Blazor Web App の Blazor ドキュメントの例

Blazor Web App を使用する場合、Blazor ドキュメントのほとんどのサンプルコンポーネントを機能させ、記事で説明されている概念を実証するには、インタラクティビティが必要です。記事で提供されているサンプルコンポーネントをテストする場合は、アプリがグローバルインタラクティビティを採用しているか、コンポーネントが対話型レンダリングモードを採用していることを確認してください。

プリレンダリング

プリレンダリングは、レンダリングされたコントロールのイベントハンドラーを有効にせずに、最初にサーバーにページコンテンツをレンダリングするプロセスです。サーバーは、最初の要求に応じてできるだけ早くページの HTML UI を出力します。これにより、アプリはユーザーに対してより応答性が高くなります。プリレンダリングでは、検索エンジンによってページランクの計算に使用される初期 HTTP 応答のコンテンツをレンダリングすることで、検索エンジンの最適化 (SEO) を向上させることもできます。

対話型コンポーネントではプリレンダリングが既定で有効になっています。

対話型ルーティングの内部ナビゲーションでは、サーバーに新しいページコンテンツを要求する必要はありません。そのため、内部ページ要求 (拡張ナビゲーションの場合を含む) では、プリレンダリングは行われません。詳細については、「静的ルーティングと対話型ルーティング」、「対話型ルーティングとプリレンダリング」、「ナビゲーションとフォーム処理の強化」を参照してください。

次の手法を使用したプリレンダリングの無効化は、最上位レベルのレンダリングモードでのみ効果があります。親コンポーネントでレンダリングモードが指定されている場合、その子のプリレンダリング設定は無視されます。この動作は、2025 年 11 月の .NET 10 リリースで考えられる変更について調査中です。

"コンポーネントインスタンス" のプリレンダリングを無効にするには、値が false の prerender フラグを、レンダリングモードに渡します。

<... @rendermode="new InteractiveServerRenderMode(prerender: false)" />
<... @rendermode="new InteractiveWebAssemblyRenderMode(prerender: false)" />
<... @rendermode="new InteractiveAutoRenderMode(prerender: false)" />

"コンポーネント定義" でプリレンダリングを無効にするには:

@rendermode @(new InteractiveServerRenderMode(prerender: false))
@rendermode @(new InteractiveWebAssemblyRenderMode(prerender: false))
@rendermode @(new InteractiveAutoRenderMode(prerender: false))

アプリ全体でプリレンダリングを無効にするには、アプリのコンポーネント階層の、ルートコンポーネントではない最上位の対話型コンポーネントで、レンダリングモードを指定します。

Blazor Web App プロジェクトテンプレートに基づくアプリの場合、アプリ全体に割り当てられるレンダリングモードは、App コンポーネント (Components/App.razor) で Routes コンポーネントが使われる場所で指定されます。次の例では、プリレンダリングを無効にして、アプリのレンダリングモードを対話型サーバーに設定しています。

<Routes @rendermode="new InteractiveServerRenderMode(prerender: false)" />

また、App コンポーネントの HeadOutletコンポーネントのプリレンダリングを無効にします:

<HeadOutlet @rendermode="new InteractiveServerRenderMode(prerender: false)" />

ルートコンポーネント (App コンポーネントなど) をルートコンポーネントの定義ファイル (.razor) の先頭にある @rendermode ディレクティブと対話形式にすることはサポートされていません。そのため、プリレンダリングを App コンポーネントで直接無効にすることはできません。

静的サーバー側レンダリング (静的 SSR)

コンポーネントは静的サーバー側レンダリング (静的 SSR) を使用します。コンポーネントが応答ストリームにレンダリングされ、インタラクティビティは有効になっていません。

次の例では、コンポーネントのレンダリングモードの指定はなく、コンポーネントはその親からレンダリングモードを継承します。先祖コンポーネントがレンダリングモードを指定していないため、次のコンポーネントはサーバー上で静的にレンダリングされます。ボタンはインタラクティブではなく、選択された場合に UpdateMessage メソッドを呼び出しません。 message の値は変更されず、コンポーネントは UI イベントに応答して再レンダリングされません。

RenderMode1.razor:

@page "/render-mode-1"

<button @onclick="UpdateMessage">Click me</button> @message

@code {
    private string message = "Not updated yet.";

    private void UpdateMessage()
    {
        message = "Somebody updated me!";
    }
}

上記のコンポーネントを Blazor Web App でローカルで使用する場合は、サーバープロジェクトの Components/Pages フォルダーにコンポーネントを配置します。サーバープロジェクトはソリューションのプロジェクトであり、名前の末尾が .Client ではありません。アプリが実行されている場合は、ブラウザーのアドレスバーで /render-mode-1 に移動します。

静的 SSR である間、Razor コンポーネントページ要求は、サーバー側の ASP.NET Core ミドルウェアパイプライン要求の処理によって、ルーティングと承認のために処理されます。 Razor コンポーネントはサーバー側の要求の処理中にレンダリングされないため、ルーティングと承認のための専用の Blazor 機能は動作しません。静的 SSR である間に使用できない Routes コンポーネントの Blazor ルーター機能には、次のような表示が含まれます。

承認されたコンテンツではありません (<NotAuthorized>...</NotAuthorized>) (NotAuthorized): Blazor Web App は通常、承認ミドルウェアの動作のカスタマイズによって、承認されていない要求をサーバー上で処理します。
コンテンツが見つかりません (<NotFound>...</NotFound>) (NotFound): Blazor Web App は通常、ブラウザーの組み込み 404 UI を表示するか、ASP.NET Core ミドルウェアを介してカスタム 404 ページ (またはその他の応答) を返すことで、サーバー上の不正な URL 要求を処理します (例: UseStatusCodePagesWithRedirects / API ドキュメント)。

アプリがルートレベルの対話機能を示す場合、サーバー側の ASP.NET Core 要求の処理は最初の静的 SSR の後に関与しません。つまり、上記の Blazor 機能は期待どおりに動作します。

静的 SSR による拡張ナビゲーションでは、JavaScript を読み込むときに特別な注意が必要です。詳細については、「静的サーバー側レンダリング (静的 SSR) を使用した ASP.NET Core Blazor JavaScript」を参照してください。

対話型サーバー側レンダリング (対話型 SSR)

対話型サーバー側レンダリング (対話型 SSR) では、Blazor Server を使用して、サーバーからコンポーネントが対話形式でレンダリングされます。ユーザー操作は、ブラウザーとのリアルタイム接続を介して処理されます。サーバーコンポーネントがレンダリングされると、回線接続が確立されます。

次の例では、コンポーネント定義に @rendermode InteractiveServer を追加することで、レンダリングモードが対話型 SSR に設定されています。このボタンを選択すると、UpdateMessage メソッドが呼び出されます。 message の値が変更され、コンポーネントが再レンダリングされて UI 内のメッセージが更新されます。

RenderMode2.razor:

@page "/render-mode-2"
@rendermode InteractiveServer

<button @onclick="UpdateMessage">Click me</button> @message

@code {
    private string message = "Not updated yet.";

    private void UpdateMessage()
    {
        message = "Somebody updated me!";
    }
}

上記のコンポーネントを Blazor Web App で使用する場合は、サーバープロジェクトの Components/Pages フォルダーにコンポーネントを配置します†。サーバープロジェクトはソリューションのプロジェクトであり、名前の末尾が .Client ではありません。アプリが実行されている場合は、ブラウザーのアドレスバーで /render-mode-2 に移動します。

重要

† アプリで Routes コンポーネントを介してグローバル WebAssembly またはグローバル自動レンダリングを採用する場合、コンポーネント定義ファイル (.razor) で対話型 SSR (@rendermode InteractiveServer) を指定する個々のコンポーネントは、.Client プロジェクトの Pages フォルダーに配置されます。

.Client プロジェクトに対話型 SSR コンポーネントを配置することは、直感に反します。このようなコンポーネントはサーバー上でのみレンダリングされるからです。

グローバル WebAssembly または自動アプリのサーバープロジェクトの Components/Pages フォルダーに対話型 SSR コンポーネントを配置すると、コンポーネントは通常どおりにプリレンダリングされ、ユーザーのブラウザーに短い時間だけ表示されます。ただし、クライアント側ルーターはコンポーネントを見つけられないため、最終的にブラウザーで 404 - Not Found になります。

そのため、アプリで Routes コンポーネントを介してグローバル WebAssembly またはグローバル自動レンダリングを採用する場合は、.Client プロジェクトの Pages フォルダーに対話型 SSR コンポーネントを配置します。

クライアント側レンダリング (CSR)

クライアント側レンダリング (CSR) では、Blazor WebAssembly を使用してコンポーネントがクライアント上で対話形式でレンダリングされます。 WebAssembly コンポーネントが最初にレンダリングされるときに、.NET ランタイムとアプリバンドルがダウンロードされ、キャッシュされます。 CSR を使用するコンポーネントは、Blazor WebAssembly ホストを設定する別のクライアントプロジェクトからビルドする必要があります。

次の例では、@rendermode InteractiveWebAssembly を使用してレンダリングモードが CSR に設定されています。このボタンを選択すると、UpdateMessage メソッドが呼び出されます。 message の値が変更され、コンポーネントが再レンダリングされて UI 内のメッセージが更新されます。

RenderMode3.razor:

@page "/render-mode-3"
@rendermode InteractiveWebAssembly

<button @onclick="UpdateMessage">Click me</button> @message

@code {
    private string message = "Not updated yet.";

    private void UpdateMessage()
    {
        message = "Somebody updated me!";
    }
}

上記のコンポーネントを Blazor Web App でローカルで使用する場合は、クライアントプロジェクトの Pages フォルダーにコンポーネントを配置します。クライアントプロジェクトはソリューションのプロジェクトであり、名前の末尾が .Client です。アプリが実行されている場合は、ブラウザーのアドレスバーで /render-mode-3 に移動します。

自動 (Auto) レンダリング

自動 (Auto) レンダリングでは、実行時にコンポーネントをレンダリングする方法が決まります。コンポーネントは、最初は、Blazor Server ホスティングモデルを使用して、対話型サーバー側レンダリング (対話型 SSR) でレンダリングされます。 .NET ランタイムとアプリバンドルがバックグラウンドでクライアントにダウンロードされ、キャッシュされるため、以降のアクセスで使用できます。

自動レンダリングモードでは、ページに既に存在するコンポーネントのレンダリングモードが動的に変更されることはありません。自動レンダリングモードは、コンポーネントでどの種類のインタラクティビティが使われるかを最初に決定して、その後、コンポーネントがページ上にある限りその種類のインタラクティビティが維持されます。この最初の決定における 1 つの要素は、WebAssembly/サーバーのインタラクティビティを備えたコンポーネントがページ上に既に存在するかどうかを考慮することです。自動モードでは、既存の対話型コンポーネントのレンダリングモードと一致するレンダリングモードが優先的に選ばれます。自動モードが既存のインタラクティビティモードの使用を優先する理由は、既存のランタイムと状態を共有しない新しい対話型ランタイムの導入を避けるためです。

自動レンダーモードを使用するコンポーネントは、Blazor WebAssembly ホストを設定する別のクライアントプロジェクトからビルドする必要があります。

次の例では、コンポーネントはプロセス全体を通してインタラクティブです。このボタンを選択すると、UpdateMessage メソッドが呼び出されます。 message の値が変更され、コンポーネントが再レンダリングされて UI 内のメッセージが更新されます。最初は、コンポーネントはサーバーからインタラクティブにレンダリングされますが、その後のアクセスでは、.NET ランタイムとアプリバンドルがダウンロードされてキャッシュされた後にクライアントからレンダリングされます。

RenderMode4.razor:

@page "/render-mode-4"
@rendermode InteractiveAuto

<button @onclick="UpdateMessage">Click me</button> @message

@code {
    private string message = "Not updated yet.";

    private void UpdateMessage()
    {
        message = "Somebody updated me!";
    }
}

レンダーモードの伝達

レンダーモードは、コンポーネント階層の下に伝達されます。

レンダーモードを適用するためのルール:

既定のレンダーモードは静的です。
対話型サーバー、(InteractiveServer)、対話型 WebAssembly (InteractiveWebAssembly)、対話型自動 (InteractiveAuto) の各レンダリングモードは、コンポーネントから使用でき、兄弟コンポーネントに異なるレンダリングモードを使用することもできます。
子コンポーネントで別のインタラクティブレンダーモードに切り替えることはできません。たとえば、サーバーコンポーネントを WebAssembly コンポーネントの子にすることはできません。
静的な親からインタラクティブな子コンポーネントに渡されるパラメーターは、JSON シリアル化可能である必要があります。つまり、静的な親コンポーネントからインタラクティブな子コンポーネントにレンダーフラグメントや子コンテンツを渡すことはできません。

次の例では、ルーティング不可能な非ページ SharedMessage コンポーネントを使用しています。レンダーモードに依存しない SharedMessage コンポーネントでは、@attribute ディレクティブによるレンダーモードは適用されません。 Blazor Web App でこれらのシナリオをテストする場合は、アプリの Components フォルダーに次のコンポーネントを配置します。

SharedMessage.razor:

<p>@Greeting</p>

<button @onclick="UpdateMessage">Click me</button> @message

<p>@ChildContent</p>

@code {
    private string message = "Not updated yet.";

    [Parameter]
    public RenderFragment? ChildContent { get; set; }

    [Parameter]
    public string Greeting { get; set; } = "Hello!";

    private void UpdateMessage()
    {
        message = "Somebody updated me!";
    }
}

レンダーモードの継承

SharedMessage コンポーネントが静的にレンダリングされる親コンポーネントに配置されている場合、SharedMessage コンポーネントも静的にレンダリングされ、インタラクティブではありません。ボタンは UpdateMessage を呼び出さず、メッセージは更新されません。

RenderMode5.razor:

@page "/render-mode-5"

<SharedMessage />

SharedMessage コンポーネントがレンダーモードを定義するコンポーネントに配置されている場合、適用されたレンダーモードが継承されます。

次の例では、SharedMessage コンポーネントはクライアントへの SignalR 接続でインタラクティブです。ボタンが UpdateMessage を呼び出し、メッセージが更新されます。

RenderMode6.razor:

@page "/render-mode-6"
@rendermode InteractiveServer

<SharedMessage />

レンダーモードが異なる子コンポーネント

次の例では、SharedMessage コンポーネントの両方がプリレンダリングされ、ページがブラウザーに表示されるときに表示されます。

対話型サーバー側レンダリング (対話型 SSR) を使用する最初の SharedMessage コンポーネントは、SignalR 回線が確立された後に対話型になります。
クライアント側レンダリング (CSR) を使用する 2 つ目の SharedMessage コンポーネントは、Blazor アプリバンドルがダウンロードされ、.NET ランタイムがクライアントでアクティブになった "後" に対話型になります。

RenderMode7.razor:

@page "/render-mode-7"

<SharedMessage @rendermode="InteractiveServer" />
<SharedMessage @rendermode="InteractiveWebAssembly" />

シリアル化可能なパラメーターを持つ子コンポーネント

次の例では、パラメーターを受け取るインタラクティブな子コンポーネントを示しています。パラメーターはシリアル化可能である必要があります。

RenderMode8.razor:

@page "/render-mode-8"

<SharedMessage @rendermode="InteractiveServer" Greeting="Welcome!" />

子コンテンツやレンダーフラグメントなどのシリアル化不可能なコンポーネントパラメーターは、サポートされません。次の例では、子コンテンツを SharedMessage コンポーネントに渡すことで、ランタイムエラーが発生します。

RenderMode9.razor:

@page "/render-mode-9"

<SharedMessage @rendermode="InteractiveServer">
    Child content
</SharedMessage>

エラー:

System.InvalidOperationException: rendermode 'InteractiveServerRenderMode' を使って、パラメーター 'ChildContent' をコンポーネント 'SharedMessage' に渡すことはできません。これは、パラメーターがデリゲート型 'Microsoft.AspNetCore.Components.RenderFragment' であるためです。これは任意のコードであり、シリアル化できません。

上記の制限を回避するには、パラメーターを持たない別のコンポーネントで子コンポーネントをラップします。これは、Router コンポーネントをラップするために Routes コンポーネント (Components/Routes.razor) を使用する Blazor Web App プロジェクトテンプレートで利用されるアプローチです。

WrapperComponent.razor:

<SharedMessage>
    Child content
</SharedMessage>

RenderMode10.razor:

@page "/render-mode-10"

<WrapperComponent @rendermode="InteractiveServer" />

前の例の場合:

子コンテンツは SharedMessage コンポーネントに渡され、ランタイムエラーは生成されません。
SharedMessage コンポーネントは、サーバー上でインタラクティブにレンダリングされます。

親と異なるレンダーモードを持つ子コンポーネント

子コンポーネントに対して、親のレンダーモードとは異なるインタラクティブレンダーモードを適用しないでください。

次のコンポーネントでは、コンポーネントのレンダリング時にランタイムエラーが発生します。

RenderMode11.razor:

@page "/render-mode-11"
@rendermode InteractiveServer

<SharedMessage @rendermode="InteractiveWebAssembly" />

エラー:

Cannot create a component of type 'BlazorSample.Components.SharedMessage' because its render mode 'Microsoft.AspNetCore.Components.Web.InteractiveWebAssemblyRenderMode' is not supported by Interactive Server rendering.

グローバル対話型アプリの静的 SSR ページ

アプリの仕様により、静的サーバー側レンダリング (静的 SSR) を採用し、サーバー上でのみ実行することが求められる一方で、アプリの rest では対話型レンダーモードが使用される場合があります。

このアプローチが役に立つのは、インタラクティブサーバーまたは WebAssembly レンダリングを使用して機能しない特定のページがアプリにある場合のみです。たとえば、HTTP Cookie の読み取り/書き込みに依存し、インタラクティブレンダリングの代わりに要求/応答サイクルでのみ動作できるページには、このアプローチを採用します。インタラクティブレンダリングを使用するページでは、静的 SSR レンダリングを強制的に使用しないでください。静的 SSR レンダリングは、エンドユーザーにとって効率と応答性が低いからです。

@attributeRazor ディレクティブに割り当てられた [ExcludeFromInteractiveRouting] 属性を使用して Razor コンポーネントページをマークします。

@attribute [ExcludeFromInteractiveRouting]

この属性を適用すると、インタラクティブルーティングでページへのナビゲーションが終了します。インバウンドナビゲーションでは、インタラクティブルーティングを使用してページを解決するのではなく、ページ全体の再読み込みが強制的に実行されます。ページ全体の再読み込みでは、最上位のルートコンポーネント (通常は App コンポーネント (App.razor)) がサーバーから再レンダリングするよう強制されるため、アプリは別の最上位レベルのレンダリングモードに切り替えることができます。

HttpContext.AcceptsInteractiveRouting 拡張メソッドを使用すると、このコンポーネントは [ExcludeFromInteractiveRouting] が現在のページに適用されているかどうかを検出できます。

App コンポーネントでは、次の例のパターンが使用されます。

[ExcludeFromInteractiveRouting] の注釈が付けられていないページは、グローバルインタラクティビティを使用した InteractiveServer レンダリングモードに既定で設定されます。 InteractiveServer を InteractiveWebAssembly または InteractiveAuto に置き換えて、別の既定のグローバルレンダリングモードを指定できます。
[ExcludeFromInteractiveRouting] の注釈が付けられたページは、静的 SSR を採用します (PageRenderMode には null が割り当てられます)。

<!DOCTYPE html>
<html>
<head>
    ...
    <HeadOutlet @rendermode="@PageRenderMode" />
</head>
<body>
    <Routes @rendermode="@PageRenderMode" />
    ...
</body>
</html>

@code {
    [CascadingParameter]
    private HttpContext HttpContext { get; set; } = default!;

    private IComponentRenderMode? PageRenderMode
        => HttpContext.AcceptsInteractiveRouting() ? InteractiveServer : null;
}

HttpContext.AcceptsInteractiveRouting 拡張メソッドを使用する代わりに、HttpContext.GetEndpoint()?.Metadata を使用してエンドポイントメタデータを手動で読み取る方法があります。

レンダーモードを細かく制御するには 2 つの方法があります。それぞれについて、次のサブセクションで説明します。

静的 SSR コンポーネントの領域 (フォルダー): 静的 SSR を採用し、同じルートパスプレフィックスを共有する必要があるコンポーネントを含むアプリの領域 (フォルダー) があります。アプリは、フォルダーへのパスに基づいて App コンポーネント内の Routes コンポーネントにレンダーモードを設定することで、レンダーモードをグローバルに制御します。
アプリ全体に分散した静的 SSR コンポーネント: 静的 SSR を採用し、サーバー上でのみ実行する必要があるコンポーネントが、アプリの周囲のさまざまな場所に分散しています。静的 SSR 専用のコンポーネントは 1 つのフォルダーに含まれておらず、共通のルートパスプレフィックスを共有していません。アプリは、コンポーネントインスタンスの @rendermode ディレクティブを使用してレンダーモードを設定することで、コンポーネントごとにレンダーモードを制御します。 App コンポーネントでリフレクションを使用して、Routes コンポーネントのレンダーモードを設定します。

どちらの場合も、静的 SSR を採用する必要があるコンポーネントは、ページ全体の再読み込みも強制する必要があります。

次の例では、HttpContext カスケードパラメーターを使用して、ページが静的にレンダリングされているかどうかを判断します。 null HttpContext は、コンポーネントが対話形式でレンダリングされていることを示します。これは、ページ全体の再読み込みをトリガーするアプリコードのシグナルとして役立ちます。

静的 SSR コンポーネントの領域 (フォルダー)

このサブセクションで説明する方法は、個々の認証とグローバル対話機能を使用して Blazor Web App プロジェクトテンプレートによって使用されます。

アプリの領域 (フォルダー) には、静的 SSR を採用し、サーバーでのみ実行する必要があるコンポーネントが含まれています。フォルダー内のコンポーネントは、同じルートパスプレフィックスを共有します。たとえば、Blazor Web App プロジェクトテンプレートの IdentityRazor コンポーネントはComponents/Account/Pages フォルダー内にあり、ルートパスプレフィックス /Account を共有します。

このフォルダーには、フォルダー内のコンポーネントにカスタムアカウントレイアウトを適用する _Imports.razor ファイルも含まれています。

@using BlazorSample.Components.Account.Shared
@layout AccountLayout

Shared フォルダーには AccountLayout レイアウトコンポーネントが保持されています。このコンポーネントは、HttpContext を使用して、コンポーネントが静的 SSR を採用しているかどうかを判断します。 Identity コンポーネントは Identity Cookie を設定しているため、静的 SSR を使用してサーバー上にレンダリングする必要があります。 HttpContext の値が null の場合、コンポーネントは対話形式でレンダリングされ、forceLoad を true に設定して NavigationManager.Refresh を呼び出すことによってページ全体の再読み込みが実行されます。これにより、静的 SSR を使用してページの完全な再レンダリングが強制されます。

Components/Account/Shared/AccountLayout.razor:

@inherits LayoutComponentBase
@layout BlazorSample.Components.Layout.MainLayout
@inject NavigationManager Navigation

@if (HttpContext is null)
{
    <p>Loading...</p>
}
else
{
    @Body
}

@code {
    [CascadingParameter]
    private HttpContext? HttpContext { get; set; }

    protected override void OnParametersSet()
    {
        if (HttpContext is null)
        {
            Navigation.Refresh(forceReload: true);
        }
    }
}

Note

Blazor Web App プロジェクトテンプレートには、Components/Account/Pages/Manage フォルダー内の Identity コンポーネント用の 2 つ目のレイアウトファイル (Components/Account/Shared フォルダー内の ManageLayout.razor) があります。 Manage フォルダーには、フォルダー内の ManageLayout コンポーネントに適用する独自の _Imports.razor ファイルがあります。独自のアプリで、入れ子になった _Imports.razor ファイルを使用すると、ページのグループにカスタムレイアウトを適用する際に便利です。

App コンポーネントでは、Account フォルダー内のコンポーネントに対するすべての要求で null レンダーモードが適用され、静的 SSR が強制されます。その他のコンポーネント要求は、対話型 SSR レンダーモード (InteractiveServer) のグローバルアプリケーションを受け取ります。

重要

null レンダーモードを適用しても、必ずしも静的 SSR が強制されるわけではありません。このセクションに示す方法を使用して、そのように動作しているだけです。

null レンダーモードは、レンダリングモードを指定しない場合と実質的に同じであり、その結果、コンポーネントは親のレンダーモードを継承します。この場合、App コンポーネントは静的 SSR を使用してレンダリングされるため、null レンダーモードの結果、Routes コンポーネントは App コンポーネントから静的 SSR を継承します。親が対話型レンダーモードを使用する子コンポーネントに対して null レンダーモードが指定されている場合、子は同じ対話型レンダリングモードを継承します。

Components/App.razor:

<Routes @rendermode="RenderModeForPage" />

...

@code {
    [CascadingParameter]
    private HttpContext HttpContext { get; set; } = default!;

    private IComponentRenderMode? RenderModeForPage => 
        HttpContext.Request.Path.StartsWithSegments("/Account")
            ? null
            : {INTERACTIVE RENDER MODE};
}

前のコードでは、アプリケーションの rest でグローバル InteractiveServer、InteractiveWebAssembly、または InteractiveAuto レンダリングを採用する必要があるかどうかに応じて、{INTERACTIVE RENDER MODE} プレースホルダーを適切な値に変更します。

Account フォルダーに静的 SSR を採用する必要があるコンポーネントは、_Imports.razor ファイルを介して適用されるレイアウトを設定する必要はありません。コンポーネントは静的 SSR でレンダリングする必要があるため、レンダリングモードを設定しません。 Account フォルダー内のコンポーネントで静的 SSR を適用するために、これ以上何も行う必要はありません。

アプリ全体に分散している静的 SSR コンポーネント

前のサブセクションでは、アプリが App コンポーネントでレンダーモードをグローバルに設定することで、コンポーネントのレンダーモードを制御していました。また、App コンポーネントでは、レンダーモードを設定するために "コンポーネントごと" のレンダーモードを採用することもできます。これにより、コンポーネントをアプリの周囲に分散して静的 SSR の採用を強制できます。このサブセクションでは、このアプローチについて説明します。

アプリには、アプリの周囲のコンポーネントに適用できるカスタムレイアウトがあります。通常、アプリの共有コンポーネントは Components/Layout フォルダーに配置されます。このコンポーネントは、HttpContext を使用して、コンポーネントが静的 SSR を採用しているかどうかを判断します。 HttpContext の値が null の場合、コンポーネントは対話形式でレンダリングされ、forceLoad を true に設定して NavigationManager.Refresh を呼び出すことによってページ全体の再読み込みが実行されます。これにより、コンポーネントについてのサーバーへの要求がトリガーされます。

Components/Layout/StaticSsrLayout.razor:

@inherits LayoutComponentBase
@layout MainLayout
@inject NavigationManager Navigation

@if (HttpContext is null)
{
    <p>Loading...</p>
}
else
{
    @Body
}

@code {
    [CascadingParameter]
    private HttpContext? HttpContext { get; set; }

    protected override void OnParametersSet()
    {
        if (HttpContext is null)
        {
            Navigation.Refresh(forceReload: true);
        }
    }
}

App コンポーネントでは、リフレクションを使用してレンダーモードを設定します。個々のコンポーネント定義ファイルに割り当てられているレンダリングモードが、Routes コンポーネントに適用されます。

Components/App.razor:

<Routes @rendermode="RenderModeForPage" />

...

@code {
    [CascadingParameter]
    private HttpContext HttpContext { get; set; } = default!;

    private IComponentRenderMode? RenderModeForPage =>
        HttpContext.GetEndpoint()?.Metadata.GetMetadata<RenderModeAttribute>()?
            .Mode;
}

静的 SSR を採用する必要がある各コンポーネントは、カスタムレイアウトを設定し、レンダーモードを指定しません。レンダーモードを指定しないと、App コンポーネントの RenderModeAttribute.Mode 値が null となり、その結果、Routes コンポーネントインスタンスにレンダーモードが割り当てられず、静的 SSR が適用されます。

重要

静的 SSR を適用するために、対話型レンダリングモードを設定せずにカスタムレイアウトを適用する以外にコンポーネントに対して何も行う必要はありません。

@layout BlazorSample.Components.Layout.StaticSsrLayout

アプリの周囲の対話型コンポーネントは、カスタム静的 SSR レイアウトの適用を回避し、App コンポーネント内のリフレクション時に Routes コンポーネントに適用される適切な対話型レンダリングモードのみを設定します。

@rendermode {INTERACTIVE RENDER MODE}

前のコードでは、コンポーネントで InteractiveServer、InteractiveWebAssembly、または InteractiveAuto レンダリングを採用する必要があるかどうかに応じて、{INTERACTIVE RENDER MODE} プレースホルダーを適切な値に変更します。

プリレンダリング中にクライアント側サービスによる解決が失敗する

コンポーネントまたはアプリでプリレンダリングが無効になっていないとすると、.Client プロジェクト内のコンポーネントはサーバー上でプリレンダリングされます。サーバーは登録されたクライアント側 Blazor サービスにアクセスできないため、これらのサービスをコンポーネントに挿入することはできず、プリレンダリング中にサービスが見つからないというエラーを受け取ります。

たとえば、グローバルな対話型 WebAssembly または対話型自動レンダリングを使用する、Blazor Web App の .Client プロジェクト内の次のような Home コンポーネントについて考えます。このコンポーネントは、環境の名前を取得するために IWebAssemblyHostEnvironment を挿入しようとします。

@page "/"
@inject IWebAssemblyHostEnvironment Environment

<PageTitle>Home</PageTitle>

<h1>Home</h1>

<p>
    Environment: @Environment.Environment
</p>

コンパイル時エラーは発生しませんが、プリレンダリング中に実行時エラーが発生します。

型 'BlazorSample.Client.Pages.Home' のプロパティ 'Environment' の値を指定できません。 There is no registered service of type 'Microsoft.AspNetCore.Components.WebAssembly.Hosting.IWebAssemblyHostEnvironment'. ('Microsoft.AspNetCore.Components.WebAssembly.Hosting.IWebAssemblyHostEnvironment' 型の登録されたサービスはありません。)

このエラーは、コンポーネントはプリレンダリング中にサーバーでコンパイルおよび実行される必要がありますが、IWebAssemblyHostEnvironment はサーバー上の登録されたサービスでないために発生します。

プリレンダリング中にアプリで値が必要ない場合は、サービスの種類自体ではなく、IServiceProvider を挿入してサービスを取得することにより、この問題を解決できます。

@page "/"
@using Microsoft.AspNetCore.Components.WebAssembly.Hosting
@inject IServiceProvider Services

<PageTitle>Home</PageTitle>

<h1>Home</h1>

<p>
    <b>Environment:</b> @environmentName
</p>

@code {
    private string? environmentName;

    protected override void OnInitialized()
    {
        if (Services.GetService<IWebAssemblyHostEnvironment>() is { } env)
        {
            environmentName = env.Environment;
        }
    }
}

ただし、上の方法は、プリレンダリング中にロジックで値が必要な場合は役に立ちません。

また、コンポーネントのプリレンダリングを無効にした場合も問題を回避できますが、多くの場合はコンポーネントの仕様を満たしていない可能性があるときに取るべき非常手段です。

このシナリオに対処するために取ることができる 3 つの方法があります。以下では、最も推奨されるものから順に示します。

共有フレームワークのサービスで "推奨": 共有フレームワークのサービスがメインプロジェクトのサーバー側に登録されていないだけの場合には、メインプロジェクトにそのサービスを登録します。これにより、プリレンダリング中にサービスを利用できるようになります。このシナリオの例については、「ASP.NET Core Blazor アプリから Web API を呼び出す」の HttpClient サービスのガイダンスを参照してください。
共有フレームワークに含まれないサービスで "推奨": サーバー上のサービスに対するカスタムサービス実装を作成します。通常は、.Client プロジェクトの対話型コンポーネントでそのサービスを使います。この方法のデモについては、「ASP.NET Core Blazor の環境」をご覧ください。
サービスの抽象化を作成し、.Client とサーバーのプロジェクトでサービスの実装を作成します。各プロジェクトでサービスを登録します。カスタムサービスをコンポーネントに挿入します。
.Client プロジェクトパッケージの参照をサーバー側パッケージに追加し、サーバーでのプリレンダリング時にはサーバー側 API の使用にフォールバックできる場合があります。

追加アセンブリからコンポーネントを検出する

参照先のプロジェクトでルーティング可能な Razor コンポーネントを検出するには、追加のアセンブリを Blazor フレームワークに公開する必要があります。詳細については、「ASP.NET Core の Blazor ルーティングとナビゲーション」を参照してください。

対話型サーバーコンポーネントが残っていない場合に回線を閉じる

対話型サーバーコンポーネントでは、ブラウザーとのリアルタイム接続 (回線) を使用して、Web UI イベントを処理します。ルートの対話型サーバーコンポーネントがレンダリングされる際、回線およびその関連付けられた状態が作成されます。ページ上に対話型サーバーコンポーネントが残っていない場合、回線は閉じられ、サーバーリソースは解放されます。

カスタムの短縮形レンダリングモード

@rendermode ディレクティブは、IComponentRenderMode 型の静的なインスタンスである 1 つのパラメーターを受け取ります。 @rendermode ディレクティブ属性は、静的かどうかに関係なく、任意のレンダリングモードインスタンスを受け取ることができます。 Blazor フレームワークには、便利な事前定義されたレンダリングモードをいくつか備えた RenderMode 静的クラスが用意されています、独自に作成することもできます。

通常、コンポーネントは次の @rendermode ディレクティブを使ってプリレンダリングを無効にします。

@rendermode @(new InteractiveServerRenderMode(prerender: false))

しかし、プリレンダリングを行わずに、アプリの _Imports ファイル (Components/_Imports.razor) を使って短縮形の対話型サーバーレンダリングモードを作成する次の例を考えてみます。

public static IComponentRenderMode InteractiveServerWithoutPrerendering { get; } = 
    new InteractiveServerRenderMode(prerender: false);

Components フォルダー全体のコンポーネントで、短縮形のレンダリングモードを使います。

@rendermode InteractiveServerWithoutPrerendering

または、1 つのコンポーネントインスタンスで、プライベートフィールドを使ってカスタムレンダリングモードを定義することもできます。

@rendermode interactiveServerWithoutPrerendering

...

@code {
    private static IComponentRenderMode interactiveServerWithoutPrerendering = 
        new InteractiveServerRenderMode(prerender: false);
}

現時点で、短縮形レンダリングモードのアプローチは、おそらく prerender フラグの詳細な指定を軽減するためにのみ役立ちます。将来的に、対話型レンダリングで使用できるフラグが追加され、さまざまなフラグの組み合わせで短縮形レンダリングモードを作成できるようになれば、短縮形のアプローチの方が便利になる可能性があります。

最上位レベルのインポートファイル (`_Imports.razor`) を使用したサービスの挿入

このセクションは Blazor Web App にのみ適用されます。

Components フォルダーにある最上位レベルのインポートファイル (Components/_Imports.razor) によって、その参照がフォルダー階層内のすべてのコンポーネントに挿入されます。これには App コンポーネント (App.razor) が含まれます。ページコンポーネントのプリレンダリングが無効になっている場合でも、App コンポーネントは常に静的にレンダリングされます。したがって、最上位レベルのインポートファイルを介してサービスを挿入すると、ページコンポーネントにおいてサービスの "2 つのインスタンス" が解決されます。

このシナリオに対処するには、Pages フォルダーに配置した新しいインポートファイル (Components/Pages/_Imports.razor) でサービスを挿入します。その場所から、サービスはページコンポーネントにおいて 1 回だけ解決されます。

その他のリソース

WebSocket 圧縮
- ASP.NET Core BlazorSignalR ガイダンス
- 対話型サーバー側の ASP.NET Core Blazor レンダリングの脅威軽減策に関するガイダンス
ASP.NET Core Blazor JavaScript と静的サーバー側レンダリング (静的 SSR)
カスケード値/パラメータとレンダリングモードの境界: この記事の前のルートレベルのカスケードパラメータに関するセクションも参照してください。
ASP.NET Core の Razor クラスライブラリ (RCL) と静的サーバー側レンダリング (静的 SSR)

ASP.NET Core Blazor JavaScript と静的サーバー側レンダリング (静的 SSR)
カスケード値/パラメータとレンダリングモードの境界: この記事の前のルートレベルのカスケードパラメータに関するセクションも参照してください。
ASP.NET Core の Razor クラスライブラリ (RCL) と静的サーバー側レンダリング (静的 SSR)

次の方法で共有

ASP.NET Core Blazor のレンダー モード

レンダー モード

対話型レンダー モードのサポートを有効にする

コンポーネント インスタンスにレンダー モードを適用する

コンポーネント定義にレンダー モードを適用する

アプリ全体にレンダリング モードを適用する

プログラムでレンダリング モードを適用する

コンポーネント定義でレンダー モードを設定する

コンポーネント インスタンスでレンダー モードを設定する

実行時にレンダリングの場所、対話機能、および割り当てられたレンダリング モードを検出する

Blazor Web App の Blazor ドキュメントの例

プリレンダリング

静的サーバー側レンダリング (静的 SSR)

対話型サーバー側レンダリング (対話型 SSR)

クライアント側レンダリング (CSR)

自動 (Auto) レンダリング

レンダー モードの伝達

レンダー モードの継承

レンダー モードが異なる子コンポーネント

シリアル化可能なパラメーターを持つ子コンポーネント

親と異なるレンダー モードを持つ子コンポーネント

グローバル対話型アプリの静的 SSR ページ

静的 SSR コンポーネントの領域 (フォルダー)

アプリ全体に分散している静的 SSR コンポーネント

プリレンダリング中にクライアント側サービスによる解決が失敗する

追加アセンブリからコンポーネントを検出する

対話型サーバー コンポーネントが残っていない場合に回線を閉じる

カスタムの短縮形レンダリング モード

最上位レベルのインポート ファイル (_Imports.razor) を使用したサービスの挿入

その他のリソース

その他のリソース

ASP.NET Core Blazor のレンダーモード

レンダーモード

対話型レンダーモードのサポートを有効にする

コンポーネントインスタンスにレンダーモードを適用する

コンポーネント定義にレンダーモードを適用する

アプリ全体にレンダリングモードを適用する

プログラムでレンダリングモードを適用する

コンポーネント定義でレンダーモードを設定する

コンポーネントインスタンスでレンダーモードを設定する

実行時にレンダリングの場所、対話機能、および割り当てられたレンダリングモードを検出する

レンダーモードの伝達

レンダーモードの継承

レンダーモードが異なる子コンポーネント

親と異なるレンダーモードを持つ子コンポーネント

対話型サーバーコンポーネントが残っていない場合に回線を閉じる

カスタムの短縮形レンダリングモード

最上位レベルのインポートファイル (`_Imports.razor`) を使用したサービスの挿入