browserCaps 的 use 項目 (ASP.NET 設定結構描述)
指定用於剖析瀏覽器功能資訊的 HTTP 要求字串，該資訊儲存在 filter 和 case 項目中。
.gif "注意事項") 注意事項 |
|---|
使用 Web.config 檔中的 browserCaps 項目來定義瀏覽器在 .NET Framework 2.0 中已經被取代，不過依然提供支援。這個項目中的資料會與來自瀏覽器定義檔 (.browser) 的資訊進行合併，而這些定義檔則是位於電腦層級的 %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers 資料夾，以及任何現有之應用程式層級的 App_Browsers 資料夾中。如需詳細資訊，請參閱瀏覽器定義檔結構描述 (browsers 項目)。 |
<use
var="server variable"
as="variableName"
/>
屬性和項目
下列各節將說明屬性、子項目和父項目。
屬性
屬性 |
描述 |
|---|---|
var |
選擇性 String 屬性。 指定經過剖析以擷取瀏覽器功能資訊的 Microsoft Internet Information Services (IIS) 伺服器變數。 預設值為 "HTTP_USER_AGENT"。 |
as |
選擇性 String 屬性。 指定可在後續的規則運算式 (Regular Expression) 中參考伺服器變數的名稱。 |
子項目
無。
父項目
項目 |
描述 |
|---|---|
configuration |
Common Language Runtime 和 .NET Framework 應用程式所使用之每一個組態檔中的必要根項目 (Root Element)。 |
system.web |
指定組態檔中 ASP.NET 組態設定的根項目 (Root Element)，並包含會設定 ASP.NET Web 應用程式以及控制這些應用程式之行為的組態項目。 |
browserCaps |
指定所支援瀏覽器的設定以及這些瀏覽器的功能。 此項目可以按需要更新以指定新的瀏覽器及功能。 如需有效瀏覽器屬性的清單，請參閱 HttpBrowserCapabilities。 |
備註
use 項目會指定用於剖析瀏覽器功能資訊的 HTTP 要求字串，而該資訊儲存在 filter 和 case 項目中。
預設組態
在 .NET Framework 2.0 版中，不會設定 use 項目，因為使用瀏覽器定義檔取代了 browserCaps 項目，以指定支援的瀏覽器及其功能。 如需詳細資訊，請參閱瀏覽器定義檔結構描述 (browsers 項目)。
在 .NET Framework 1.0 版和 1.1 版中，Machine.config 檔案中設定的預設 use 項目數量繁多，無法在此一一列出。 如需瀏覽器資料的更新，請移至 cyScape, Inc 網站， 網址為 http://www.cyscape.com/browsercaps。 定期的裝置更新會取代此瀏覽器功能區段。
範例
下列程式碼範例會示範如何指定 IIS HTTP_USER_AGENT 伺服器變數是瀏覽器功能資訊的來源。
<use var="HTTP_USER_AGENT">
項目資訊
組態區段處理常式 |
|
組態成員 |
|
可設定的位置 |
Machine.config 根層次的 Web.config 應用程式層級的 Web.config 虛擬或實體目錄層級的 Web.config |
需求 |
Microsoft Internet Information Services (IIS) 5.0、5.1 或 6.0 版 .NET Framework 2.0 (已取代)、1.1 或 1.0 版 Microsoft Visual Studio 2003 或 Visual Studio 2005 |
請參閱
工作
HOW TO：在 ASP.NET Web 網頁中偵測瀏覽器類型和瀏覽器功能
參考
browserCaps 項目 (ASP.NET 設定結構描述)
system.web 項目 (ASP.NET 設定結構描述)
browserCaps 的 filter 項目 (ASP.NET 設定結構描述)
browserCaps 的 result 項目 (ASP.NET 設定結構描述)
HttpCapabilitiesSectionHandler