blazor

レンダーモードは Razor コンポーネントがどこで実行され、インタラクティブになるかどうかを決めます。.NET 11 の 4 つのモード、コンポーネントが何を継承するかを決める伝播ルール、そして実行時にどのモードが適用されたかを教えてくれる RendererInfo と AssignedRenderMode を解説します。

MAUI 10.0.100 で MauiBlazorWebViewBuilderExtensions.UsePlatformHandler が導入されました。AddMauiBlazorWebView() が登録するものをすべて作り直すことなく BlazorWebViewHandler を差し替えられる正式な拡張ポイントです。2 つのオーバーロードと、1 つの呼び出し順序の落とし穴を解説します。

downloadFileFromStream の JS モジュールは不要です。TypedResults.File を返す minimal API エンドポイントを指す download 属性付きのアンカーをレンダリングするか、AntiforgeryToken を含むプレーンな HTML フォームを POST します。download 属性が Blazor の拡張ナビゲーションによるクリック横取りを防ぐ理由、data-enhance がファイルを黙って捨てる理由、cookie と bearer の落とし穴も解説します。

シングルトンは DbContext を注入できませんが、IDbContextFactory<T> なら注入できます。AddDbContextFactory がファクトリを既定でシングルトンとして登録するからです。呼び出しごとにコンテキストを生成して破棄し、インスタンスは決して保持しないでください。

.NET 11 Preview 7 では、ブラウザーのタブが非表示になったときに対話型 Server サーキットを一時停止するオプトインのパッケージが追加され、実際にはいないユーザーが抱え込んでいたメモリと SignalR 接続が解放されます。

.NET 10 では Blazor スクリプトが埋め込みリソースではなくなったため blazor.server.js が 404 になります。ホストプロジェクトに RequiresAspNetWebAssets を追加するか、.razor ファイルを置いてください。

再接続モーダルはアプリがクラッシュしたのではなく、SignalR の circuit が切れたという合図です。再試行が failed で終わるか rejected で終わるかを確認し、セッションアフィニティ、3 分の保持期間、32 KB 制限を直すか、[PersistentState] で状態を保存してください。

.NET 11 で CPU 集約的な処理を Blazor WebAssembly の UI スレッドから追い出すための完全ガイドです。Task.Run が役に立たない理由、新しい blazorwebworker テンプレート、キャンセルとタイムアウトに対応した WebWorkerClient API、JSExport のマーシャリング制限、そして worker ごとに支払う 2 つ目のランタイムのコストを解説します。

プリレンダリングはブラウザーのないサーバー上でコンポーネントを実行するため、IJSRuntime が例外を投げます。呼び出しを OnAfterRenderAsync に移すか、RendererInfo.IsInteractive で分岐するか、プリレンダリングを無効にしてください。

静的サーバーレンダリングの Blazor でセッション状態を読むには、HttpContext.Session にアクセスして手動でシリアライズする必要がありました。.NET 11 Preview 5 は [SupplyParameterFromSession] を追加し、コンポーネントのプロパティをセッションキーに直接バインドします。