關於 ASP.NET File Change Notification (FCN) 的一些事

這幾天在測試如何達成修改 web.config 而不引起 IIS 重啟時看到幾種做法，其中一個是調整 web.config 的 fcnMode 設定值，過去不認識這個設定引起我的好奇而查了些資料，剛好趁這個機會多認識個設定，順手做個筆記幫助記憶

什麼是 FCN

ASP.NET 應用程式會透過一個 Win32 的 function 稱為 ReadDirectoryChangesW 來監控資料夾及檔案的變更，根據變更的內容觸發 FCN (File Change Notification) 來卸載 AppDomain ，而達到重啟的目地

從 ASP.NET WebForm 時期開始，只要修改 ASP.NET 站台下的特定檔案或是異動特定資料夾就會引發 IIS 重啟，這些特殊檔案及資料夾包括(但不限於)下列內容

  • 檔案
    1. web.config (也包含父層的 config)
    2. Global.asax
  • 資料夾
    1. bin 資料夾
    2. App_Code 資料夾
    3. App_WebReferences 資料夾
    4. App_GlobalResources 資料夾
    5. 所在實體資料夾及虛擬資料夾

設定 ASP.NET 站台的 FCN

fcnMode 是 .NET Framework 4.5 開始加入至 web.config 的屬性，可以透過官方預先定義的 enum 來設定單一 website 中的 file change notifications mode

設定值說明
Default1預設值：每個子資料夾都會建立一個物件來監控
Disabled2停用檔案變更通知
NotSet0檔案變更通知未設定，每個子資料夾都會建立一個物件來監控，也就是使用預設行為
Single3只會建立一個物件來監控所有資料夾

心得

之前只知道 ASP.NET 應用程式下的幾個資料夾及檔案不能想改就改，會引起 IIS restart、把線上 user 踢掉，但從來沒有想過是怎麼做或是背後的流程，只把它當做是慣例及規則來遵守，直到同事的問題讓我有機會多了解其中的做法，雖然對於完整流程跟細節還是沒有完整掌握：fcnMode 中 Default 及 NotSet 有什麼差異(文件上寫得行為完全相同)，Single 的目地及好處….等等，但已經算是更接近了核心些，相信日後如果看到相關文件時就不會完全沒有頭緒了

參考資訊

  1. All about ASP.Net File Change Notification (FCN)
  2. ASP.NET File Change Notifications, exactly which files and directories are monitored?
  3. fcnMode