共用方式為


ASP.NET Core 的 .NET 熱重載支援

.NET 熱重載會將程式代碼變更,包括樣式表單的變更套用至執行中的應用程式,而不重新啟動應用程式,而不會遺失應用程式狀態。 .NET 6 或更新版本中所有 ASP.NET Core 都支援熱重載。

一般而言,更新的程式代碼會重新執行,以在下列情況下生效:

  • 某些啟動邏輯只會執行一次:
    • 中間件,除非程式代碼更新是內嵌中間件委派。
    • 已設定的服務。
    • 路由建立和設定,除非程式碼更新是路由處理器委派(例如 OnInitialized)。
  • Blazor 應用程式中,架構會自動 Razor 觸發元件 渲染。
  • 在 MVC 和 Razor Pages 應用程式中,Hot Reload 會自動觸發瀏覽器重新整理。
  • 拿掉 Razor元件參數 屬性並不會使元件重新呈現。 應用程式必須重新啟動。

如需支援案例的詳細資訊,請參閱支援的程式代碼變更(C# 和 Visual Basic)。

Blazor WebAssembly

Blazor WebAssembly 即時重載支援下列程式碼變更:

  • 新類型。
  • 巢狀類別。
  • 方法主體的大部分變更,例如新增、移除和編輯變數、表達式和語句。
  • Lambda 運算式本地函數的主體變更。
  • 將靜態和實例方法新增至現有的類型。
  • 將靜態和實例欄位、事件和屬性新增至現有的類型。
  • 將靜態 Lambda 新增至現有的方法。
  • 將擷取 this 的 Lambda 新增到已經擷取 this 的現有方法中。

請注意,移除先前設定元件參數值的屬性時,會處置元件並重新初始化,以將移除的參數設定回其預設值。

對於 Blazor WebAssembly 應用程式,不支援下列程式代碼變更:

Blazor WebAssembly 即時重載支援下列程式碼變更:

  • 新類型。
  • 巢狀類別。
  • 方法主體的大部分變更,例如新增、移除和編輯變數、表達式和語句。
  • Lambda 運算式本地函數的主體變更。
  • 將靜態和實例方法新增至現有的類型。
  • 將靜態欄位新增至現有的類型。
  • 將靜態 Lambda 新增至現有的方法。
  • 將擷取 this 的 Lambda 新增到已經擷取 this 的現有方法中。

請注意,移除先前設定元件參數值的屬性時,會處置元件並重新初始化,以將移除的參數設定回其預設值。

對於 Blazor WebAssembly 應用程式,不支援下列程式代碼變更:

  • 加入新的 await 運算符yield 關鍵詞 表達式。
  • 變更方法參數的名稱。
  • 新增 (非static) 實例欄位、事件或屬性。

Blazor WebAssembly 即時重載支援下列程式碼變更:

  • 方法主體的大部分變更,例如新增、移除和編輯變數、表達式和語句。
  • Lambda 運算式本地函數的主體變更。

對於 Blazor WebAssembly 應用程式,不支援下列程式代碼變更:

  • 新增 Lambda 函數或本機函式。
  • 加入新的 await 運算符yield 關鍵詞 表達式。
  • 變更方法參數的名稱。
  • 方法主體以外的變更。
  • 新增 (非static) 實例欄位、事件或屬性。

.NET 命令列介面 (CLI)

使用 dotnet watch 命令啟動熱重載:

dotnet watch

若要強制應用程式重建並重新啟動,請在命令殼層中使用 鍵盤組合 Ctrl+R

當進行不被支援的程式碼編輯時,此類編輯稱為 不雅編輯,系統會詢問您是否想重新啟動應用程式:

  • :重新啟動應用程式。
  • :不會重新啟動應用程式,而且不會讓應用程式在沒有套用變更的情況下執行。
  • 一律:在發生粗魯的編輯時,視需要重新啟動應用程式。
  • 不:不會重新啟動應用程式,並避免未來的提示。

若要停用熱重載的支援,請將 --no-hot-reload 選項傳遞至 dotnet watch 命令:

dotnet watch --no-hot-reload

停用熱重載

Properties/launchSettings.json 中的下列設定會停用熱重載:

"hotReloadEnabled" : false

其他資源

如需詳細資訊,請參閱 Visual Studio 檔中的下列資源: