ASP.NET 瀏覽器註冊工具 (Aspnet_regbrowsers.exe)
ASP.NET 瀏覽器註冊工具 (Asnet_regbrowsers.exe) 會剖析所有系統範圍的瀏覽器定義並將其編譯成組件,然後將該組件安裝至全域組件快取中。 這個工具會使用 .NET Framework Browsers 子目錄中的瀏覽器定義檔 (.BROWSER 檔)。
注意事項 |
---|
如需如何尋找正確 Asnet_regbrowsers.exe 版本的詳細資訊,請參閱本主題後面的尋找正確的 Aspnet_regbrowsers.exe 版本。 |
語法
aspnet_regbrowsers.exe <options>
選項
選項 |
描述 |
---|---|
-? |
在命令視窗中顯示 Aspnet_regbrowsers.exe 說明文字。 |
-i |
建立執行階段瀏覽器能力組件,並將其安裝至全域組件快取中。 |
-u |
從全域組件快取中解除安裝執行階段瀏覽器能力組件。 |
備註
瀏覽器定義檔可以作用於整個系統或特定應用程式,每種類型分別儲存在不同的位置。 系統範圍的瀏覽器定義檔會儲存在下列路徑中:
%SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers
這個目錄包含 .NET Framework 對應版本隨附之預先定義的瀏覽器定義檔,以及從軟體更新檔或 Service Pack 中複製而來的任何其他瀏覽器定義檔。 您可以針對想要以全域方式提供給 Web 應用程式的瀏覽器定義加入新的瀏覽器檔案。 但是,請不要變更 ASP.NET 隨附之預先定義的瀏覽器定義檔,因為 Service Pack 可能會更新這些檔案而覆寫您的變更。
特定應用程式的瀏覽器定義檔可以放置在應用程式的 App_Browsers 目錄中。 使用 ASP.NET 瀏覽器註冊工具對於儲存在應用程式 App_Browsers 目錄中之特定應用程式的瀏覽器定義檔沒有作用。
修改系統層級的瀏覽器定義檔時,並不會自動更新所有應用程式的瀏覽器功能。 您必須執行 ASP.NET 瀏覽器註冊工具,以更新瀏覽器能力組件。
注意事項 |
---|
ASP.NET 瀏覽器註冊工具會編譯 %SystemRoot% 底下 Browsers 目錄中的瀏覽器定義,這個目錄會對應至 %WinDir% 底下您從中執行此工具的 Framework 目錄。.NET Framework 2.0 隨附的工具版本會更新以 .NET Framework 2.0、.NET Framework 3.0 或 .NET Framework 3.5 為目標之網站的瀏覽器定義組件。.NET Framework 4 隨附的工具版本會更新以 .NET Framework 4 為目標之網站的瀏覽器定義組件。 |
ASP.NET 瀏覽器註冊工具會剖析所有系統範圍的瀏覽器定義並將其編譯成組件,然後將該組件安裝至全域組件快取中。 如果系統範圍的瀏覽器定義中有錯誤,這個工具便會報告這些錯誤。 瀏覽器能力組件是提供給系統中所有的 Web 應用程式使用。 請注意,您也可以使用 BrowserCapabilitiesCodeGenerator 類別,以程式設計方式重新編譯系統範圍的瀏覽器定義檔。
行為
執行 ASP.NET 瀏覽器註冊工具時,會建立新的組件,而它對於所有 Web 應用程式的影響就像是變更 Machine.config 檔一樣:回收所有執行中的 Web 應用程式並重新啟動 Microsoft Internet Information Services (IIS)。 這個工具也會產生隨機的私用語彙基元 (Token) 檔,並且建立用來簽署組件的金鑰檔,以便能將組件安裝至全域組件快取中。 當工具執行完後,便會移除金鑰檔,只留下公開金鑰 (Public Key)。
在執行階段,瀏覽器定義資訊已合併至 BrowserCapabilitiesFactory 物件中的已知瀏覽器集合。 當發出要求時,ASP.NET 會根據要求標頭來識別要求的瀏覽器,並會編譯對應至所要求之瀏覽器類型的 HttpBrowserCapabilities 物件。
注意事項 |
---|
.NET Framework 1.1 會將瀏覽器定義儲存在 Web.config 檔案的 browserCaps 項目中。在 .NET Framework 2.0 版中,這個區段已被取代,但是仍然受支援。這個項目中的資料會與來自瀏覽器定義檔案的資訊合併。 |
系統會使用其他應用程式原始程式檔來剖析並編譯位於應用程式層級的瀏覽器定義檔。 若為網站專案,編譯作業會在應用程式啟動時視需要進行,而且當您對應用程式的 Browsers 目錄進行任何變更時,應用程式會自動重新編譯。 ASP.NET 瀏覽器註冊工具對於應用程式層級的瀏覽器資訊檔沒有作用。
範例
若要剖析所有系統範圍的瀏覽器定義並將其編譯成組件,然後將該組件安裝至全域組件快取中,請執行下列命令:
aspnet_ regbrowsers.exe -i
您也可以使用這個工具,從全域組件快取中移除瀏覽器定義組件。 下列命令會從全域組件快取中移除瀏覽器定義組件:
aspnet_ regbrowsers.exe -u
若要取得使用 ASP.NET 瀏覽器註冊工具的說明,請使用下列命令:
aspnet_ regbrowsers.exe -?
尋找正確的 Aspnet_regbrowsers.exe 版本
Aspnet_regbrowsers.exe 安裝在 Microsoft .NET Framework 目錄中。 如果電腦正在並存執行多個 .NET Framework 版本,就可能會安裝此工具的多個版本。 下表將針對不同的 .NET Framework 版本列出此工具的安裝位置。
.NET Framework 的版本 |
Aspnet_regbrowsers.exe 檔案的位置 |
---|---|
.NET Framework 2.0 版、3.0 版和 3.5 版 (32 位元系統) |
%windir%\Microsoft.NET\Framework\v2.0.50727 |
.NET Framework 2.0 版、3.0 版和 3.5 版 (64 位元系統) |
%windir%\Microsoft.NET\Framework64\v2.0.50727 |
.NET Framework 4 版 (32 位元系統) |
%windir%\Microsoft.NET\Framework\v4.0.30319 |
.NET Framework 4 版 (64 位元系統) |
%windir%\Microsoft.NET\Framework64\v4.0.30319 |
請參閱
工作
HOW TO:在 ASP.NET Web 網頁中偵測瀏覽器類型和瀏覽器功能