ASP.NET Core 3.1 の新機能

  • [アーティクル]

この記事では、ASP.NET Core 3.1 の最も大きな変更点について説明します。また、関連するドキュメントへのリンクも示します。

Razor コンポーネントの部分クラスのサポート

Razor コンポーネントが部分クラスとして生成されるようになりました。 Razor コンポーネントのコードは、単一ファイル内のコンポーネントのすべてのコードを定義するのではなく、部分クラスとして定義された分離コード ファイルを使用して記述できます。 詳細については、「部分クラスのサポート」を参照してください。

コンポーネント タグ ヘルパーと最上位レベルのコンポーネントへのパラメーターの引き渡し

ASP.NET Core 3.0 がインストールされた Blazor では、コンポーネントは HTML ヘルパー (Html.RenderComponentAsync) を使用してページとビューにレンダリングされていました。 ASP.NET Core 3.1 では、新しいコンポーネント タグ ヘルパーを使用して、ページまたはビューからコンポーネントがレンダリングされます。

<component type="typeof(Counter)" render-mode="ServerPrerendered" />

HTML ヘルパーは ASP.NET Core 3.1 でも引き続きサポートされていますが、コンポーネント タグ ヘルパーをお勧めします。

初回のレンダリング時に、Blazor Server アプリで最上位レベルのコンポーネントにパラメーターを渡すことができるようになりました。 以前は、最上位レベルのコンポーネントにパラメーターを渡すには、RenderMode.Static を使用するしかありませんでした。 このリリースでは、RenderMode.Server と RenderMode.ServerPrerendered の両方がサポートされています。 指定されたパラメーター値はすべて JSON としてシリアル化され、初回の応答に含まれます。

たとえば、インクリメント量 (IncrementAmount) を使用して Counter コンポーネントを事前レンダリングする場合は、次のようになります。

<component type="typeof(Counter)" render-mode="ServerPrerendered" 
    param-IncrementAmount="10" />

詳細については、コンポーネントの Razor Pages と MVC アプリへの統合に関するページを参照してください。

Http.sys での共有キューのサポート

Http.sys では、匿名の要求キューの作成がサポートされています。 ASP.NET Core 3.1 では、既存の名前付き HTTP.sys 要求キューに作成またはアタッチする機能が追加されています。 既存の名前付き HTTP.sys 要求キューに作成またはアタッチすると、キューを所有する HTTP.sys コントローラー プロセスがリスナー プロセスから独立しているシナリオが可能になります。 このような独立によって、リスナー プロセスの再起動の間に既存の接続とエンキューされた要求を保持することができます。

public static IHostBuilder CreateHostBuilder(string[] args) =>
     Host.CreateDefaultBuilder(args)
        .ConfigureWebHostDefaults(webBuilder =>
        {
            // ...
            webBuilder.UseHttpSys(options =>
            {
                options.RequestQueueName = "MyExistingQueue";
                options.RequestQueueMode = RequestQueueMode.CreateOrAttach;
            });
        });

SameSite cookie の重大な変更

SameSite cookie の動作が、今後のブラウザーの変更を反映するように変更されました。 これは、AzureAd、OpenIdConnect、WsFederation などの認証シナリオに影響を与える可能性があります。 詳細については、「ASP.NET Core で SameSite cookie を使用する」を参照してください。

Blazor アプリのイベントに対する既定のアクションを回避する

イベントに対する既定のアクションを回避するには、@on{EVENT}:preventDefault ディレクティブ属性を使用します。 次の例では、テキスト ボックスにキーの文字を表示する既定のアクションが回避されます。

<input value="@_count" @onkeypress="KeyHandler" @onkeypress:preventDefault />

詳細については、「既定のアクションを禁止する」を参照してください。

Blazor アプリでのイベント伝達を停止する

イベント伝達を停止するには、@on{EVENT}:stopPropagation ディレクティブ属性を使用します。 次の例では、チェック ボックスをオンにすると、子 <div> からのクリック イベントが親 <div> に伝達されなくなります。

<input @bind="_stopPropagation" type="checkbox" />

<div @onclick="OnSelectParentDiv">
    <div @onclick="OnSelectChildDiv" @onclick:stopPropagation="_stopPropagation">
        ...
    </div>
</div>

@code {
    private bool _stopPropagation = false;
}

詳細については、「イベントの伝達の停止」を参照してください。

Blazor アプリの開発中の詳細なエラー

開発中に Blazor アプリが正常に機能していない場合、アプリからの詳細なエラー情報を受け取ることで、問題のトラブルシューティングと修正に役立ちます。 エラーが発生すると Blazor アプリによって画面の下部に金色のバーが表示されます。

  • 開発中は、金色のバーによってブラウザー コンソールが表示され、そこで例外を確認できます。
  • 実稼働環境では、金色のバーによって、エラーが発生したことがユーザーに通知され、ブラウザーの更新が推奨されます。

詳細については、「ASP.NET Core Blazor アプリのエラーを処理する」を参照してください。