.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 應用程式,不支援下列程式代碼變更:
Blazor WebAssembly 即時重載支援下列程式碼變更:
- 方法主體的大部分變更,例如新增、移除和編輯變數、表達式和語句。
- Lambda 運算式和本地函數的主體變更。
對於 Blazor WebAssembly 應用程式,不支援下列程式代碼變更:
.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 檔中的下列資源: