browserCaps 的 use 項目 (ASP.NET 設定結構描述)

發行項
05/28/2012

指定用於剖析瀏覽器功能資訊的 HTTP 要求字串，該資訊儲存在 filter 和 case 項目中。

注意

使用 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) 中參考伺服器變數的名稱。

var

選擇性 String 屬性。

指定經過剖析以擷取瀏覽器功能資訊的 Microsoft Internet Information Services (IIS) 伺服器變數。

預設值為 "HTTP_USER_AGENT"。

選擇性 String 屬性。

指定可在後續的規則運算式 (Regular Expression) 中參考伺服器變數的名稱。

子項目

無。

父項目

項目	描述
configuration	Common Language Runtime 和 .NET Framework 應用程式所使用之每一個組態檔中的必要根項目 (Root Element)。
system.web	指定組態檔中 ASP.NET 組態設定的根項目 (Root Element)，並包含會設定 ASP.NET Web 應用程式以及控制這些應用程式之行為的組態項目。
browserCaps	指定所支援瀏覽器的設定以及這些瀏覽器的功能。此項目可以按需要更新以指定新的瀏覽器及功能。如需有效瀏覽器屬性的清單，請參閱 HttpBrowserCapabilities。

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">

項目資訊

組態區段處理常式	HttpCapabilitiesSectionHandler
組態成員	Browsers
可設定的位置	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

請參閱

共用方式為

browserCaps 的 use 項目 (ASP.NET 設定結構描述)

屬性和項目

屬性

子項目

父項目

備註

預設組態

範例

項目資訊

請參閱

工作

參考

概念

其他資源

其他資源