ASP.NET Core MVC 的相容性版本

發行項
11/30/2023

SetCompatibilityVersion 方法對於 ASP.NET Core 3.0 應用程式來說是一個無作業的方法。也就是說，使用任何 CompatibilityVersion 值呼叫 SetCompatibilityVersion 對該應用程式都沒有影響。

ASP.NET Core 的下一個次要版本可能會提供新的 CompatibilityVersion 值。
CompatibilityVersion 值 Version_2_0 到 Version_2_2 被標示為 [Obsolete(...)]。
請參閱防偽、CORS、診斷、Mvc 和路由傳送中的重大 API 變更。此清單包含相容性參數的重大變更。

若要了解 SetCompatibilityVersion 如何與 ASP.NET Core 2.x 應用程式一起運作，請選取本文的 ASP.NET Core 2.2 版本。

SetCompatibilityVersion 方法可讓 ASP.NET Core 2.x 應用程式加入或退出 ASP.NET Core MVC 2.1 或 2.2 中所引入的可能重大行為變更。這些可能的重大行為變更通常在於 MVC 子系統的運作方式，以及執行階段呼叫您的程式碼的方式。透過選擇加入，您可以取得最新的行為和 ASP.NET Core 的長期行為。

下列程式碼會將相容性模式設定為 ASP.NET Core 2.2：

public void ConfigureServices(IServiceCollection services)
{
    services.AddMvc()
        .SetCompatibilityVersion(CompatibilityVersion.Version_2_2);
}

建議您使用最新版本 (CompatibilityVersion.Latest) 測試應用程式。預計大部分的應用程式都不會使用最新版本進行重大行為變更。

呼叫 SetCompatibilityVersion(CompatibilityVersion.Version_2_0) 的應用程式會受到保護，以防止 ASP.NET Core 2.1/2.2 MVC 版本中所引進的可能重大行為變更。這項保護：

不適用於所有 2.1 和更新版本的變更，它的目標是 MVC 子系統中的可能重大 ASP.NET Core 執行階段行為變更。
不會延伸至 ASP.NET Core 3.0。

適用於 ASP.NET Core 2.1 和 2.2 應用程式且不會呼叫 SetCompatibilityVersion 的預設相容性為 2.0 相容性。也就是說，不呼叫 SetCompatibilityVersion 等同於呼叫 SetCompatibilityVersion(CompatibilityVersion.Version_2_0)。

下列程式碼會將相容性模式設定為 ASP.NET Core 2.2，但下列行為除外：

public void ConfigureServices(IServiceCollection services)
{
    services.AddMvc()
        // Include the 2.2 behaviors
        .SetCompatibilityVersion(CompatibilityVersion.Version_2_2)
        // Except for the following.
        .AddMvcOptions(options =>
        {
            // Don't combine authorize filters (keep 2.0 behavior).
            options.AllowCombiningAuthorizeFilters = false;
            // All exceptions thrown by an IInputFormatter are treated
            // as model state errors (keep 2.0 behavior).
            options.InputFormatterExceptionPolicy =
                InputFormatterExceptionPolicy.AllExceptions;
        });
}

對於出現重大行為變更的應用程式，使用適當的相容性參數：

可讓您使用最新版本，並選擇退出特定的重大行為變更。
讓您有時間來更新您的應用程式，使其適用於最新的變更。

MvcOptions 文件充分說明變更的項目，以及所做變更對於大部分使用者來說都得到改善的原因。

對於 ASP.NET Core 3.0，相容性參數支援的舊行為已被移除。我們覺得這些是有利於幾乎所有使用者的正向變更。透過在 2.1 和 2.2 中引入這些變更，大部分的應用程式都可以受益，而其他應用程式則有時間進行更新。

ASP.NET Core MVC 的相容性版本

意見反應

其他資源